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Using  Flash  to  add  sound  to  a  Web  page:  an  introduction 

Playing  audio  on  Web  pages  Sound  files,  which  come  in  a  variety  of  formats,  are  handled  differently  and  inconsistently 
by  different  browsers  and  on  different  computers.  For  some  measure  of  predictability  and  control,  users  can  bring  audio 
into  Dreamweaver  by  first  inserting  it  into  a  SWF  file  (created  by  Macromedia  Flash).  The  SWF  file  will  be  played  with 
the  Flash  plug-in,  which  comes  with  most  browsers.  Flash  is  a  streaming  technology,  so  audio  files  can  start  playing 
even  before  the  entire  file  has  been  completely  downloaded. 

JavaScript  control  of  audio  embedded  in  an  SWF  file  A  SWF  file  can  be  controlled  with  JavaScript  behaviors.  For 
instance,  the  clicking  of  a  button  can  trigger  the  playing  of  a  SWF  file  which  houses  an  audio  file.  Unfortunately,  a  few 
browsers  do  not  allow  JavaScript  to  control  embedded  elements  such  as  Flash  movies.  (See  Not  all  browsers  support 
JavaScript  control  of  embedded  content  [TechNote  15431]  for  more  information.) 

Below  is  a  chart  showing  which  browsers  support  JavaScript  control  of  embedded  elements: 


Supported  browsers 

Windows 

Macintosh 

Internet  Explorer  4.x 

V 

Internet  Explorer  5.x 

V 

Netscape  4.x 

V 

Netscape  6 

Bringing  an  MP3  audio  file  into  Dreamweaver  using  a  Flash  SWF  file  The  tutorials  in  this  series  use  both  Flash  5 
and  Dreamweaver  4  to  add  audio  to  a  Web  page.  They  each  use  one  kind  of  audio,  MP3  (Motion  Picture  Experts  Group 
Audio),  which  is  embedded  in  a  SWF  file  in  Flash  and  then  played  or  controlled  in  Dreamweaver.  Other  audio  formats 
(such  as  WAV  for  Windows  or  AIFF  for  Macintosh)  can  also  be  added  to  the  SWF  file.  The  tutorials  include: 


► 

Using  Flash  to  add  background  musicto  a  Web  page  (TechNote  1 5345) 
After  embedding  an  MP3  audio  file  into  a  Flash  SWF  file,  you  can  then 
add  the  SWF  file  to  a  Dreamweaver  document  for  background  sound. 

► 

Using  Flash  to  play  audio  when  a  button  is  clicked  (TechNote  1 5326) 
Trigger  the  playing  of  the  SWF  file  by  attaching  a  JavaScript  control 
behavior  to  a  button  or  linked  text. 

► 

Using  Flash  to  play  audio  in  a  specific  frame  on  the  timeline  (TechNote 

1 5347)  Delay  the  start  of  the  SWF  file  by  placing  a  behavior  on  the 
Dreamweaver  timeline. 

Additional  informationFor  more  information  about  working  with  audio  in  Flash,  see  the  following  Flash  TechNotes 
and  articles: 
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How  to  create  a  simple  sound  toggle  (TechNote  14821) 

Supported  audio  import  formats  (TechNote  14068) 

Streaming  and  file  optimization  techniques  for  Flash  Player 

For  more  information  about  working  with  audio  in  Dreamweaver,  see  the  following  Dreamweaver  TechNotes  and 
articles: 


Adding  sound  and  video  to  your  Web  site 

Troubleshooting  the  Dreamweaver  2  Control  Sound  behavior 
(TechNote  14049) 

What  can  prevent  JavaScript  control  over  audio?  (TechNote  1 4285) 

Playing  a  sound  completely  before  opening  a  page  (TechNote  1 2903) 

Troubleshooting  "Sample:  Saving  to  MS  Access  using 
ASP"  in  Firefly  tutorial 

This  TechNote  covers  some  of  the  common  pitfalls  users  come  across  when  working  through  the  Firefly  tutorial:  Firefly 
Components  Help  >Tutorials  >  Advanced  Topics>Sample:  Saving  to  MS  Access  using  ASP. 

These  tips  may  also  help  users  troubleshoot  errors  in  their  own  Firefly  applications. 

Connector  failed  to  load  data: 


Error  opening  URL  ''http://localhost/fireflySamples/asp/getdata.asp”  Connector  'myConnector'  failed  to  load  data.  [Code]HTTP.CONNECT 
[Source]  [Description]Couldn't  establish  connection  with  'http://localhost/fireflySamples/asp/getdata.asp'. 

This  error  occurs  when  running  Control  >Test  Movie  on  thesample.fla  file.  No  data  appears  in  the  grid  and  the  Output 
window  displays  the  error  message  above. 

Some  possible  causes  of  this  error  are: 


► 

The  Virtual  Directory  named  fireflySamples  was  not  created  in  IIS. 

► 

The  Virtual  Directory  name  was  spelled  incorrectly. 

► 

If  you  are  working  with  your  own  Firefly  application,  check  the  spelling 
of  the  URL  to  your  ASP  file  in  the  following  places: 

► 

FxXMLConnector  visual  property  editor  >  Properties  tab 
>  Source  URL  field 

► 

FxXMLResolver  visual  property  editor  >  Properties  tab  > 
Resolve  URL  field 

Resolver  couldn't  apply  Delta  Packet: 
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Error  opening  URL  "http://localhost/fireflySamples/asp/saveData.asp"  Resolver  'myResolver'  couldn't  apply  delta  packet. 
[Code]HTTP.CONNECT  [Source]  [DescriptionJCouldn't  establish  connection  with  'http://localhost/fireflySamples/asp/saveData.asp'. 

This  error  occurs  when  running  Control  >Test  Movie  on  thesample.fla  file.  When  the  user  clicks  the  Add  button,  enters 
some  information  in  the  new  row  and  then  clicks  the  Save  button  the  Output  window  displays  the  error  message  above. 
The  most  probable  cause  of  this  error  is  that  the  user  entered  a  Record  ID  number  that  already  exists  for  another  record. 
The  Access  databasesample.mdb  has  the  MemberlD  field  defined  as  a  primary  key  which  does  not  allow  duplicate 
values. 


Error  opening  Delta  Packet:: 


<delta_packet  />  Error  opening  URL  ”http://localhost/fireflysamples/asp/SaveDeltaPacket.asp”  did  not  work 


This  error  occurs  when  running  Control  >Test  Movie  on  the  sample.fla  file.  When  the  user  clicks  the  Add  button, 
enters  some  information  in  the  new  row  and  then  clicks  the  Show  Delta  Packet  button,  the  Output  window  displays  the 
error  message  above.  The  most  probable  cause  of  this  error  is  that  theC:\Program  Files\Macromedia\Flash 
MX\Samples\Firefly\  folder  does  not  have  the  correct  Windows  permissions.  To  set  the  permissions  for  this  folder  in 
Windows  2000: 


1 

Open  Windows  Explorer  and  browse  to:C:\Program 
Files\Macromedia\Flash  MX\Samples\Firefly\ 

2 

Right-click  the  Firefly  folder  and  choose  Properties. 

3 

Select  the  Security  tab  and  click  the  Add  button  . 

4 

Choose  your  local  machine  from  the  Look  in:  field  and  scroll  down  to 
the  name  IUSR_yourComputer. 

5 

Click  Add  and  then  give  the  IUSR  account  Full  Control. 

Note:  Windows  NT  and  Windows  XP  have  similar  steps.  For  more  details  on  Windows  permissions,  please  see  the 
following  Dreamweaver  TechNotes: 


► 

Understanding  anonymous  authentication  and  the  IUSR  account 
(TechNote  15378) 

► 

Setting  IIS  web  server  permissions  (TechNote  1 5376) 

► 

Understanding  NTFS  permissions  (TechNote  15545) 

Delta  Packet  is  empty: 


The  Delta  Packet  is  empty  when  the  Show  Delta  Packet  button  is  clicked 

This  issue  occurs  when  running  Control  >Test  Movie  on  thesample.fla  file.  When  the  user  clicks  the  Add  button,  enters 
some  information  in  the  new  row  and  then  clicks  the  Show  Delta  Packet  button,  the  Output  window  just  displays  the 
following:<delta_packet  />.  This  occurs  because  the  information  entered  in  the  new  row  has  not  yet  posted  to  the 
dataset.  The  data  is  not  posted  until  the  user  moves  to  a  different  record  in  the  grid.  Note  that  the  saveUpdates()  method 
automatically  calls  post  before  the  DeltaPacket  is  saved  to  the  server.  Therefore,  an  insert  would  be  saved  to  the  server 
even  if  the  user  did  not  select  another  record  in  the  grid. 
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Transparent  background  in  a  SWF  file 


The  background  color  (Stage  color)  of  a  SWF  file  can  be  set  to  transparent.  The  background  color  or  image  of  the 
HTML  page  that  contains  the  SWF  file  shows  through.  This  technique  allows  layering  of  SWF  content  with  DHTML 
(Dynamic  HTML)  content. 

Not  every  web  browser  handles  transparency  in  the  same  way.  Be  sure  to  test  your  SWF  file  in  all  browsers  that  you 
want  to  enable  your  audience  to  use.  Most  Linux  browsers  do  not  support  Flash  transparency.  This  table  lists  several 
browsers  that  support  transparency. 


Using  the  Publish  Settings  in  Flash  Professional 

The  HTML  for  a  SWF  file  can  be  created  using  the  Publish  Settings  feature  in  Flash.  The  Publish  Settings  dialog  box 
provides  an  option  to  affect  the  WMODE  setting.  The  options  selected  in  the  Publish  Settings  are  added  to  the  HTML 
source  code  automatically. 

1  Choose  File  >  Publish  Settings.  Make  sure  that  HTML  is  selected. 

2  Select  HTML. 

3  Choose  Transparent  Windowless  from  the  Window  Mode  menu  to  make  the  SWF  file's  background  disappear  in 
browsers  that  support  this  feature. 

4  Publish  the  document. 

This  video  shows  how  to  perform  these  steps  in  Flash  Professional: 


Using  the  Properties  panel  in  Dreamweaver 

Follow  the  steps  below,  and  Dreamweaver  inserts  the  correct  HTML  code  automatically. 

1  In  Dreamweaver,  insert  the  SWF  file  into  an  HTML  page. 

2  Select  the  SWF  file  in  the  Design  View. 

3  In  the  Properties  panel,  choose  Parameters. 

4  For  the  Parameter,  enter  "wmode"  (without  quotes).  For  the  Value,  enter  "transparent.'' 

5  Save  the  document.  The  HTML  page  is  complete. 

This  video  shows  how  to  perform  these  steps  in  Dreamweaver: 


Editing  the  HTML  code  manually 

To  edit  an  existing  HTML  page,  add  the  WMODE  parameters  to  the  HTML  code. 

Add  the  following  parameter  to  the  OBJECT  tag: 

<param  name="wmode"  value= "transparent " > 

For  more  information  about  editing  HTML  tags  manually  for  SWF  content,  see  Object  Tag  Syntax. 
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More  Help  topics 

Flash  content  displays  on  top  of  all  DHTML  layers 

Tips  for  using  Flash  sprites  in  Director 

Introduction 

The  following  tips  and  strategies  are  not  all  inclusive.  The  purpose  of  this  TechNote  is  to  address  some  of  the  most 
frequent  questions  regarding  the  use  of  Flash  sprites  in  Director.  The  material  is  current  for  Macromedia  Director  MX 
2004  and  Macromedia  Flash  MX  2004  (SWF  7.0),  and  the  following  strategies  should  be  useful  for  future  versions  as 

well. 

General  approach 

It  is  important  to  note  that  it  is  easier  to  use  Flash  sprites  if  they  have  been  designed  specifically  for  the  Director  piece. 
You  may  encounter  difficulties  when  attempting  to  incorporate  a  finished  SWF  that  was  originally  designed  for  a 
browser.  Flash  files  may  or  may  not  make  a  successful  translation  when  being  hosted  by  another  application.  Although 
the  majority  of  SWF  files  may  work  in  Director,  not  all  SWF  files  can  be  used  in  all  hosts  with  equal  success. 

Scenario  1 

A  common  method  for  a  SWF  file  designed  for  browsers  utilizes  Load  Movie  actions  to  link  different  SWF  files 
together.  In  Director,  the  SWF  files  would  be  imported  as  multiple  SWF  sprites  and  then  controlled  through  Lingo.  If 
you  wish  to  repurpose  a  finished  SWF  file  that  loads  other  SWF  files,  you  will  modify  the  original  Flash  FLA  file  to 
create  appropriate  elements  for  the  new  Director  project. 

Scenario  2: 

Flash  movies  may  have  originally  been  designed  using  the  FSCommand  actions  to  speak  to  the  surrounding  browser. 
Although  it  is  possible  to  write  Lingo  to  accommodate  such  messages,  it  is  easier  to  send  an  actual  Lingo:  message  to 
the  Director  host.  The  choice  to  keep  elements  within  the  control  of  the  target  host  is  also  useful  for  triggering  URLs. 

For  example,  when  incorporating  pre-existing  Flash  files  which  use  a  GetURL  action,  this  script  is  embedded  within 
Shockwave,  which  is  then  embedded  within  a  browser.  It  is  more  efficient  to  design  the  Flash  sprite  to  pass  a  message 
to  the  Director  host,  asking  that  it  request  an  URL  from  the  Shockwave  host  with  the  normal  goToNetPage  command. 
If  command  sequences  are  deeply  embedded  within  each  other,  troubleshooting  is  more  complex  than  if  each  element 
passes  a  simple  message  to  its  own  host. 

For  additional  information,  refer  to  Triggering  events  from  a  Flash  sprite  using  "Lingo:"  (TechNote  16165).  In  both  of 
these  situations,  it  may  be  possible  to  retrofit  a  movie  that  was  designed  for  another  host.  However,  it  is  usually  much 
easier  if  the  Flash  movie  was  created  specifically  as  media  to  be  hosted  in  Director. 

The  Flash  Asset  Xtra 

When  creating  Flash  Sprites  or  creating  Flash  objects  usingnewObject  in  Director  MX  2004,  the  Flash  Asset  Xtra  is 
required.  The  Flash  Asset  Xtra  provides  all  the  Flash  functionality  in  Director,  and  the  Flash  Player  does  not  need  to  be 
installed  on  the  end-user's  machine.  If  the  Xtra  is  not  included  with  the  projector,  the  Director  application  will  not  play 
correctly.  For  more  information  about  including  Xtras  in  projectors  and  Shockwave  movies,  refer  to  How  are  Xtras 
included  in  Director  projectors  loaded?  (TechNote  12057). 

Performance  Tips 
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When  authoring  Director  projects  that  incorporate  Flash  assets,  developers  should  follow  some  specific  performance 
tips.  The  tips  listed  under  the  "Flash  >  Performance  Tips"  section  of  the  Director  help  documentation  are  essential  for 
optimum  playback.  The  information  on  the  static  and  frame  rate  properties  are  especially  useful  for  increasing 
performance  with  some  Flash  pieces. 

Note  that  when  using  the  Flash  Asset  Xtra  in  a  projector  or  Shockwave  movie,  the  CPU  usage  meter  may  show  100% 
usage.  This  reading  does  not  effect  system  or  movie  performance.  For  more  details  on  why  this  happens  refer  to  Why 
does  the  CPU  usage  monitor  go  to  100%  when  I  run  Director?  (TechNote  8151). 

When  using  Flash  Sprites  in  Director,  each  Flash  Sprite  creates  a  new  instance  of  the  Flash  Asset  Xtra.  This  means  that 
as  more  Flash  Sprites  are  used,  more  memory  is  required  by  the  application  as  the  computations  required  exponentially 
increase.  Developers  have  reported  performance  difficulties  with  over  twenty  simultaneous  Flash  sprites,  which  is  to 
be  expected.  Each  overlaid  element  is  turning  curves-to-antialiased-pixels  many  times  per  second.  Real  time  rendering 
requires  more  computations  than  compositing  bitmaps,  and  this  should  be  taken  into  consideration  when  authoring  a 
movie.  For  more  details,  please  see  Why  can  Shockwave  offer  higher  framerates  than  Flash?  (TechNote  13981)  and 
Multiple  Flash  assets  in  Director  movies  may  cause  memory  problems  in  projectors  (TechNote  15624). 

One  strategy  involves  constructing  an  interface  using  as  many  Flash  sprites  as  desired.  Once  the  final  layout  has  been 
designed,  performance  is  optimized  by  collapsing  multiple  SWFs  into  a  single  SWF  sprite.  If  all  the  elements  are 
combined  in  Flash  to  create  a  single  SWF  (particularly  if  it  can  be  set  as  a  static  SWF),  then  the  computations  the 
processor  needs  to  perform  each  second  will  be  greatly  reduced.  The  summary  for  this  section  is  to  keep  a  flattened 
hierarchy,  use  simple  elements,  all  at  the  same  level  in  Director  whenever  possible.  Although  it  is  possible  to  nest  the 
logic  or  media  deeply  within  SWFs,  it  simplifies  the  authoring  process  to  maintain  a  set  of  simple  SWFs  and  allow  Lingo 
to  access  all  the  command  functions. 

Performance  in  Director  MX  2004 

Director  MX  2004  addresses  the  memory  problems  associated  with  multiple  Flash  assets  through  the  Flash  asset 
commonPlayer.  The  commonPlayer  is  a  property  that  applies  to  all  Flash  assets,  vector  shapes,  and  Flash  components. 
It  lets  you  load  multiple  Flash  sprites  into  one  instance  of  the  Flash  Player  rather  than  requiring  one  Flash  Player  for 
each  Flash  sprite  on  the  stage.  The  commonPlayer  feature  is  designed  to  provide  better  Flash  playback  performance  in 
Director  projects  that  use  large  numbers  of  Flash  assets. 

Sound  in  Flash 

Audio  is  a  special  case.  It  is  possible  to  embed  audio  in  the  SWF,  inside  Director  and  inside  other  applications  (for 
example:  browsers).  If  it  is  necessary  to  change  the  audio  synch  or  interactivity,  then  revisions  will  require  tracing  back 
through  multiple  files.  It  simplifies  the  process  if  all  media  elements  are  accessible  within  the  Director  interface,  rather 
than  embedded  media  elements  one  within  another.  A  Flash  button  can  send  a  message  to  the  Director  host  requesting 
an  audio  click.  This  can  also  resolve  difficulties  with  audio-blending  in  certain  versions.  Be  aware  that  some 
compression  options  in  Flash  can  conflict  with  blending  of  other  audio  sources  on  certain  hardware  systems.  For 
example,  the  streamsynch  property  can  cause  problems  which  are  documented  in  Flash  audio  stutters  in  Director  on  a 
Windows  system  (TechNote  14814).  If  all  the  audio  is  inside  Director,  the  sound  files  are  easier  to  blend  and  edit. 

New  functionality  in  Director  MX  and  Director  MX  2004 

Director  MX  now  has  the  ability  to  access  objects  within  a  Flash  6  SWF  file.  This  functionality  allows  Director  to 
retrieve  and  set  data  with  Flash  native  objects  and  access  Flash  SWF  functionality  such  as  XML  parsing,  Macromedia 
Flash  Communication  Server,  Flash  Remoting,  local  and  remote  shared  objects.  For  more  information  on  this 
functionality  please  refer  to  the  Director  MX  help  files. 
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Macromedia  Flash  MX  2004  components  are  bundled  movie  clips  with  ActionScript  programming  interfaces.  Director 
comes  with  a  set  of  user  interface  components,  including  list  boxes,  radio  buttons,  check  boxes,  a  scroll  pane,  and  more. 
Developers  can  access  Flash  function  directly  by  simply  using:Sprite("flashSprite").FlashFunctionName.  For  more 
information  see  Calling  Flash  ActionScript  functions  using  Lingo  (TechNote  18541).  For  more  information  on  Cross 
product  support  and  methodology  see  theCross-Product  Integration  section  in  the  Developers  Center. 

Flash  in  Shockwave  issues 

It  is  important  to  verify  whether  or  not  the  Shockwave  Player  can  support  the  desired  Flash  features  when  viewing  Flash 
sprites  in  Shockwave  through  browsers.  For  a  list  of  which  versions  of  Flash  are  compatible  with  each  version  of 
Director  see  Flash  support  in  Director  (TechNote  14754). 

Summary 

It  is  possible  to  use  a  range  of  Flash  movies  inside  a  Director  piece,  but  it  is  also  possible  to  create  Flash  movies  which 
are  difficult  to  use  in  Director.  Keep  in  mind  the  following: 

•  It  is  generally  easiest  if  the  Flash  movies  used  were  created  specifically  to  be  hosted  in  Director. 

•  Use  a  flattened  hierarchy  where  logic  and  media  are  handled  in  Director  rather  than  embedded  in  the  Flash  sprite. 

•  A  good  object-oriented  design  with  firm  boundaries  to  individual  objects  can  provide  a  flexible  project  with  the 
desired  level  of  performance. 


Tips  for  Reducing  Dropped  Frames  in  Enhanced 
QuickTime  Export 

Introduced  in  Adobe  Flash  CS3,  the  enhanced  QuickTime  Export  feature  made  it  possible  to  export  Flash  content  as 
video,  including  the  animation  in  movie  clips  and  an  animation  provided  by  ActionScript.  However,  there  are  certain 
technical  limitations  that  prevent  Flash  from  guaranteeing  that  no  frames  will  be  dropped  when  recording  the  Flash 
content.  The  following  tips  can  be  used  to  help  minimize  the  likelihood  of  having  dropped  frames  in  your  enhanced 
QuickTime  export. 

•  Turn  off  other  applications.  When  recording,  Flash  uses  all  of  your  system's  available  resources  as  much  as  possible, 
so  any  interference  of  the  system  performance  affects  the  result  of  the  recording.  We  recommend  you  quit  other 
applications  before  exporting  to  a  video. 

•  Turn  off  audio.  The  audio  in  Flash  may  also  slow  the  performance,  possibly  causing  dropped  frames.  Turn  off  the 
audio,  if  you  have  many  dropped  frames  in  the  first  attempt.  Other  video  editing  tools  can  be  used  to  add  the  audio 
to  the  video  after  export. 

•  Reduce  frame  rate.  If  the  Flash  content  dimensions  are  a  full  size  NTSC  video,  740  x  480,  and  frame  rate  is  30  fps, 
you  are  more  likely  to  have  dropped  frames.  Reducing  the  fps  of  Flash  content  increases  the  chance  of  grabbing  all 
the  frames.  Other  video  editing  tools  can  be  used  to  adjust  the  frame  rate  of  the  video  after  export. 

•  Optimize  your  animation.  Try  to  avoid  a  lot  of  screen  motion.  The  greater  the  area  of  change  on  the  screen,  the 
more  likely  slowdown  will  occur.  Also,  if  possible,  restrict  your  use  of  transparency  and  alpha  channels  as  they  too 
can  cause  poor  performance. 

•  Use  ActionScript  3.0.  Animation  created  by  ActionScript  2.0  and  ActionScript  3.0  are  different  in  playback 
performance.  Convert  the  ActionScript  in  your  animation  to  ActionScript  3.0  for  optimized  performance. 
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•  Dimension  settingsin  two  places.  The  dimension  settings  in  Export  Settings  dialog  sets  the  dimension  of  the  SWF 
movie  to  be  captured.  The  Size  settings  in  QuickTime  Settings  dialog  sets  the  dimension  of  the  exported  MOV  files. 
If  the  SWF  size  is  smaller  than  the  exported  MOV  size,  the  picture  quality  will  be  degraded;  if  it  is  larger  than  the 
exported  MOV  file,  you  may  have  better  picture  quality.  For  best  quality  (and  often  performance)  these  settings 
should  match. 

•  Changing  the  preference  for  temp  data.  During  export,  Flash  compresses  the  export  data  when  recording  it  to 
memory,  allowing  Flash  to  record  longer  content.  This  compressing  process,  however,  consumes  time,  and  may  drop 
frames.  Using  a  custom  command,  this  preference  can  be  toggled  and  turned  on  or  off  to  help  reduce  that  possibility. 
For  a  short,  heavy  content,  it  is  recommended  you  turn  it  off  and  record  the  temp  data  to  memory  without 
compression.  Otherwise,  you  should  leave  the  option  turned  on.  The  command  for  changing  this  option  is  available 
for  download  below.  You  can  run  this  command  using  the  Commands  >  Run  Command...  option  in  Flash.  Inputting 
a  value  of  1  will  turn  on  compression  while  a  value  of  0  will  turn  it  off. To  install  the  custom  command; 

1  Download  videoPreferenceCommand.zip. 

2  Unzip  the  file  and  install  to  the  appropriate  location:  Windows  Vista:  [boot  drive] \Users\  [username]  \Local 
Settings\Application  Data\Adobe\Flash  CS3\language\Configuration\Commands  Windows  XP:  [boot 
drive]  \Documents  and  Settings\[user]\Local  Settings \Application  Data\Adobe\Flash 

CS3\language\Configuration\Commands  Mac  OS  X:  Macintosh  HD /Users/ [username] /Library/ Application 
Support/ Adobe/Flash  CS3/language/Configuration/Commands 


Additional  Information 

For  more  information  in  regards  to  the  first  frame  of  an  export  being  dropped,  see  "The  first  frame  may  not  be  recorded 
when  exporting  as  a  QuickTime  Movie  in  Adobe  CS3  Flash  Professional"  (TechNote  kb401500  ). 


Tips  for  optimizing  ActionScript  in  Adobe  Flash  movies 

If  speed  is  a  primary  concern,  look  at  the  visual  aspects  of  the  site.  In  most  cases  the  majority  of  speed  bottlenecks  occur 
when  attempting  too  many  (or  too  complicated  rendering  tasks.)  Optimizing  the  visual  can  achieve  significantly 
greater  gains  than  a  slight  improvement  in  code  processing. 

For  optimization  tips,  see  Streaming  and  file  optimization  techniques  for  Flash  Player. 

Some  items  to  consider: 
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► 

When  possible,  try  not  to  manipulate  long  strings.  Break  the  strings  up 
into  small  pieces,  run  the  string  operations  and  concatenate  the  result 
into  a  final  string  for  output.  The  smaller  the  string  the  faster  the 
operation  will  complete.  This  should  also  be  a  consideration  with 
incoming  XML  data.  Large  amounts  of  XML  should  be  broken  up 
before  loading  into  Macromedia  Flash  if  possible. 

► 

If  manipulating  a  lot  of  data  on  the  client,  consider  using  the  server  to 
pre-filter  the  data  that  the  client  actually  sees.  Server  side  processing 
will  be  faster,  eases  the  processing  burden  on  the  Macromedia  Flash 
Player  (and  the  viewer's  CPU),  and  will  become  increasingly  important 
as  the  audience  for  low-memory  portable  devices,  such  as  PDA's  and 
cell  phones,  increases. 

► 

Avoid  lengthy  scripts  that  may  prevent  the  user  from  interacting  with 
the  content.  If  it's  necessary  to  process  a  lot  of  information, 
considering  breaking  the  processing  into  chunks  and  distributing  the 
task  across  a  series  of  frames.  One  frame  can  do  the  initial  calculation, 
set  up  the  necessary  variables,  then  finish  processing  and  rendering 
the  visuals.  In  the  next  frame  pick  up  those  variables,  perform  more 
calculation,  then  again  allow  the  frame  to  process  and  render.  This 
type  of  "distributed  processing"  may  be  more  difficult  to  write  and 
debug,  but  will  insure  a  more  consistent  experience  for  your  users. 

On  a  similar  note,  there  may  be  simple  scripts  that  are 
being  evaluated  on  every  frame.  Consider  if  it  might  be 
possible  to  run  these  scripts  once,  save  their  results  and 
call  them  when  needed  instead  of  rerunning  the  script 
every  time. 

► 

If  you're  controlling  a  large  number  of  movie  clip  instances  using 
ActionScript,  consider  how  many  times  you  might  be  repeating  the 
same  routines  or  resetting  the  same  variables.  Can  that  information  be 
broken  out  into  a  single  custom  Function?  Is  it  possible  to  use  a 
function  to  calculate  that  information  once  and  pass  it  back  to  the  clip 
instances  instead  of  processing  the  function  multiple  times? 

For  Function  details,  see  the  definition  of  Function  in  the 
online  Flash  Dictionary 

► 

In  some  cases,  it  may  be  possible  to  achieve  faster  script  processing  by 
using  deprecated  Macromedia  Flash  4  ActionScript  syntax.  This  might 
achieve  an  immediate  goal  of  faster  code  processing,  but  keep  in  mind 
that  deprecated  syntax  is  deprecated  for  a  reason.  There  is  no 
guarantee  that  the  underlying  mechanisms  used  to  achieve  that 
speed  will  be  around  in  the  next  revision  of  the  Flash  Player,  and  an 
extensive  recoding  might  be  necessary. 

Note:Macromedia  Flash  Player  6  includes  significantly 
improved  ActionScript  performance,  eliminating 
virtually  all  the  circumstances  in  which  it  would  be 
necessary  to  use  Macromedia  Flash  4  ActionScript 
syntax. 
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► 

Bitmaps  are  fixed-resolution  images.  They  look  best  when  one  pixel  of 
source  imagery  exactly  matches  one  pixel  of  screen  display.  Because 
SWF  streams  and  scales,  it's  rare  to  have  this  type  of  one-to-one 
correspondence.  This  means  you're  asking  the  computer  to  create 
new  screen  pixels  from  groups  of  source  pixels  and  draw  them 
onscreen  every  time  the  playback  moves  to  a  new  frame.  Bitmap- 
heavy  projects  can  be  slower  to  redraw  because  of  this.  Make  use  of 
vectors  and  bitmap  fills  whenever  possible  to  avoid  this. 

Also,  it  may  seem  simple  to  mention  it,  but  any  item  used 
more  than  once  in  the  SWF  should  be  inside  a  symbol. 
This  includes  bitmaps,  imported  vector  art  and  art  created 
in  Flash. 

► 

Looping:  tight  loops  can  be  problematic.  Give  the  player  a  chance  to 
break  out  of  the  loop  so  it  can  process  other  actions. 

► 

Minimize  simultaneous  streaming  whenever  possible.  Multiple 
streams  cost  processing  power  and  bandwidth. If  multiple  streams  of 
audio  are  necessary  or  multiple  SWF's  must  be  loaded,  use  a 
preloading  technique  at  the  beginning  of  the  movie.  This  costs  more 
time  up  front,  but  at  that  point  it's  possible  to  let  the  viewer  know  that 
something  is  happening.  Later  in  the  movie  a  lag  might  be  interpreted 
as  a  system  problem  or  may  lose  the  viewer's  attention. 

Slow  opening  transition  when  editing  a  symbol  in  Flash 
on  Windows  Vista 


Issue 

When  double-clicking  or  editing  a  symbol  currently  located  on  the  stage  in  an  Adobe  Flash  document,  you  will  see  a 
slow  animation  of  an  expandingdashed  box  outline  before  the  symbol  is  opened. 

Reason 

This  is  a  known  issue  and  is  related  to  an  incompatibility  with  Flash  and  Windows  Vista's  Aero  graphics  style. 

Solution 

To  prevent  this  behavior  you  will  need  to  either: 

•  disable  Aero  or 

•  disable  desktop  composition  specifically  for  Flash 

To  disable  desktop  composition  (Aero)  specifically  for  Flash: 

1  Right-click  on  the  Flash  icon  (or  a  shortcut  to  Flash)  and  select  properties. 

2  In  the  resulting  Flash  Properties  dialog,  select  the  Compatibility  tab. 

3  In  the  Settings  portion  of  the  Compatibility  tab,  check  the  Disable  desktop  composition  option. 
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4  Restart  Flash  if  currently  open. 

Now,  upon  launching  Flash,  Windows  will  exit  Aero.  Without  Aero  enabled,  editing  symbols  will  no  longer  exhibit  this 
behavior. 


Set  variables  in  a  Flash  movie 


A  variable  is  a  container  that  holds  information,  such  as  numerical  or  string  data.  This  TechNote  outlines  the  five  main 
ways  to  set  variables  in  a  Flash  movie.  For  more  information  on  variables,  refer  to  page  191  of  the  Flash  4  manual, 
"Setting  and  identifying  variables". 

There  are  five  main  ways  to  set  variables  in  Flash: 

•  Using  the  action  Set  Variable 

•  Using  an  editable  text  field 

•  Using  the  action  Load  Variables 

•  Appended  on  a  query  string  in  HTML  tags 

•  Using  JavaScript  methods 
Set  Variable 

Use  the  Set  Variable  action  in  Flash.  This  example  uses  a  frame  action,  though  it  can  also  be  done  using  a  button  action. 
To  set  a  variable  using  "Set  Variable": 

1  Open  a  new  document  in  Flash. 

2  Highlight  Frame  1  in  the  timeline. 

3  Choose  Modify  >  Frame  from  the  menu. 

4  In  the  Actions  tab,  click  the  "+"  sign,  and  choose  "Set  Variable". 

5  In  the  "Variable"  field,  type  "text"  without  quotes.  This  is  the  variable  name. 

6  In  the  "Value"  field,  type  "hello"  without  quotes. 

7  Click  OK. 

8  Choose  Control  >  Test  Movie  to  test  this.  The  variable  named  "text"  will  be  assigned  the  specified  value  "hello”  when 
the  movie  plays  the  first  frame  of  the  timeline.  Also,  in  this  example,  setting  the  variable  will  not  show  any  visual 
change  in  the  movie.  However,  variables  and  their  values  can  be  previewed  in  Test  Movie  mode  by  choosing  Control 
>  List  Variables. 


Note:  To  the  right  of  the  "Variable"  and  "Value  fields",  there  is  a  pop-up  menu,  which  contains  "String  Literal", 
"Expression",  and  "Expression  Editor".  The  first  time  a  variable  is  set,  make  sure  the  variable  field  is  set  to  "String 
Literal".  For  more  information  creating  expressions,  please  refer  to  page  196  of  the  Flash  4  manual. 

Use  a  Text  Field 
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Text  fields  in  Flash  can  be  used  to  assign  a  value  to  a  variable  by  user  text  entry,  or  to  display  the  value  of  a  variable.  For 
more  information  on  creating  text  fields,  see  page  1 17  of  the  manual  for  more  information  on  text  fields,  and  Using 
Type  Blocks  and  Text  Fields  in  Flash  (TechNote  14154). 

To  set  a  variable  using  a  text  field: 

1  Open  a  new  document  in  Flash. 

2  Select  the  text  tool. 

3  Click  the  Text  Field  Modifier.  (See  image  below) 

4  Using  this  tool,  click  and  drag  to  create  a  box  to  the  desired  width  and  height  of  the  text  field. 

5  Choose  Modify  >  Text  Field  from  the  menu,  to  access  the  Text  Field  Properties  dialog  box. 

6  In  the  field  marked  "Variable",  type  "text"  (without  quotes).  Click  OK. 

7  Choose  Control  >  Test  Movie.  Any  value  entered  into  the  text  field  will  become  the  value  of  "text". 

Note:  A  value  you  assign  to  a  variable  will  also  display  in  a  text  field  with  the  same  variable  value.  (For  instance,  if  "text" 
is  set  to  "hello",  the  word  "hello"  will  display  in  the  text  field  with  variable  name  "text".) 

Load  Variables 

Variables  can  be  obtained  from  a  remote  file  by  using  the  action  Load  Variables.  The  remote  file  can  be  a  text  file  or  a 
server-side  application  such  as  ASP,  CGI  or  ColdFusion.  This  example  uses  a  text  file  as  the  data  source,  with  the 
command  issued  by  a  frame  action. 

To  obtain  external  data  using  Load  Variables: 

1  Create  a  text  file  (using  SimpleText  or  Notepad)  containing  only  the  text  "text=hello"  without  quotes.  Save  this  text 
file  as  "text.txt"  to  your  working  folder. 

2  Open  a  new  document  in  Flash. 

3  Highlight  Frame  1  in  the  timeline. 

4  Choose  Modify  >  Frame  from  the  menu. 

5  In  the  Actions  tab,  click  the  "+"  sign,  and  choose  "Load/Unload  Movie"  from  the  pop-up  menu. 

6  On  the  right,  choose  the"  Load  Variables  into  Location"  radio  button. 

7  In  the  "URL"  field,  type  the  name  of  the  text  file  "text.txt". 

8  In  the  "Level"  field,  type  the  number  0.  Click  OK. 

9  Create  a  text  field  on  the  stage  with  variable  name  "text".  This  will  demonstrate  when  the  data  has  been  loaded. 

1 0  Publish  the  movie  to  the  same  folder  as  the  text  file  "text.txt". 

1 1  When  the  movie  plays  Frame  1,  the  movie  will  pull  the  variable  and  value  pair  ”text=hello"  from  your  data  source 
into  the  current  timeline.  Additional  data  can  be  added  to  this  by  using  the  syntax  specified  on  page  183. 

Note:  Special  characters  (such  as  punctuation,  numeric  operators,  and  other  non-alphanumeric  data)  must  be  URL 
encoded  to  be  translated  into  the  Flash  movie.  For  more  information,  see  URL  Encoding:  Reading  special  characters 
from  a  text  file  (TechNote  14143). 

On  a  Query  String  in  HTML  tags 
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Variables  can  be  passed  from  an  HTML  page  into  the  inserted  Flash  movie  that  it  encompasses.  This  approach  requires 
that  tags  are  written  into  the  HTML  source  that  address  both  Internet  Explorer  and  Netscape.  The  variable  information 
is  passed  to  the  main  timeline  of  the  Flash  movie  as  soon  as  the  SWF  loads.  The  example  below  uses  a  text  field  on  the 
main  timeline  to  display  the  variable  that  is  being  passed. 

To  pass  variables  on  a  query  string  to  a  Flash  movie  in  HTML: 

1  Create  a  new  Flash  movie  and  save  the  file  with  the  name  "movie.fla".  Create  a  text  field  with  variable  name  "text". 
(See  above  for  steps  ) 

2  Publish  both  Flash  (movie.swf)  and  HTML  (movie.html)  files. 

3  Open  the  movie.html  file  with  a  text  editor  such  as  SimpleText  or  Notepad. 

4  Find  the  OBJECT  tag.  Look  for  this  tag:<PARAM  NAME=movie  VALUE="movie.swf"> 

5  At  the  end  of  "movie.swf",  add  "?text=hello"  It  should  look  like  this:<PARAM  NAME=movie  VALUE= 
"movie.swf?text=hello"> 

6  Find  the  EMBED  tag.  Look  for  this:<EMBED  href="/support/flash/ts/documents/movie.swf " 

7  Again,  replace  the  filename  "movie.swf"  with  "movie.swf?text=hello".  It  should  look  like  this:<EMBED 
href=7support/flash/ts/documents/movie.swf?text=hello" 

8  Save  the  file  as  "movie.html",  replacing  the  old  file. 

9  When  you  open  the  HTML  file  in  a  browser,  the  text  field  "text"  in  the  Flash  movie  should  display  the  value  "hello". 

Note:  Multiple  variables  can  be  passed  with  this  syntax:  "movie.swf?variablel=valuel&variable2=value2".  The  value 
must  be  assigned  in  both  the  OBJECT  and  EMBED  tags  for  this  method  to  work  in  all  browsers.  Also,  Internet  Explorer 
on  the  Macintosh  will  not  display  the  movie  locally.  To  preview  this  sample  in  that  browser,  upload  the  SWF  and  HTML 
files  to  a  server  and  type  in  the  full  "http://"  address. 

Using  JavaScript 

It  is  possible  to  pass  variables  to  a  Flash  movie  from  JavaScript  in  the  HTML  page.  This  is  just  one  example  of  a  strategy 
that  can  be  used  in  many  ways.  In  the  example  below,  a  link  in  the  HTML  page  passes  a  variable  when  clicked  to  a  text 
field  in  the  Flash  movie.  This  method  will  not  work  on  Internet  Explorer  for  the  Macintosh. 

To  create  this  sample,  do  the  following: 

1  Open  a  new  Flash  document. 

2  Create  a  text  field  with  variable  name  "text".  (See  above  for  steps  ) 

3  Add  an  additional  frame  to  the  Flash  movie  so  that  it  has  at  least  two  frames. 

4  Save  the  document  as  "movie.fla"  and  publish  your  document  (using  the  "Default"  HTML  template)  to  create  the 
Flash  movie  ("movie.swf")  and  HTML  page  ("movie.html"). 

5  Open  the  "movie.html"  file  with  a  text  editor  such  as  SimpleText  or  Notepad. 

6  Between  the  HEAD  tags,  insert  this  code.  Be  sure  to  copy  it  exactly: 

<script  language  =  " JavaScript "><!- -  function  PassFlash(){ 
window . document . movie . SetVariable ( "text " ,  "hello");  }  //--> 

< / scripts 

7  In  the  EMBED  tag,  look  for  the  HEIGHT  and  WIDTH  parameters.  Insert  the  following  parameter  (if  it  is  not 
already  in  there):NAME=movie 

8  After  this  has  been  added,  insert  the  follow  code  directly  following  this:swLiveConnect=true 
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9  Just  above  the  closing  body  tag  ("</body>"),  insert  this  codexa  href="#"  onClick="PassFlash()">Pass  The 
Variable</a> 

1 0  Save  the  document  as  "movie.html",  replacing  the  old  version  of  this  file. 

1 1  Open  "movie.html"  in  a  browser.  To  pass  the  variable  to  the  movie,  click  the  text  "Pass  the  Variable".  The  value  of 
"text"  becomes  "hello",  and  the  text  field  will  display  this  new  value. 

Note:  A  complete  description  of  JavaScript  is  beyond  the  scope  of  this  TechNote.  Complete  technical  documentation 
is  available  from  numerous  third-party  JavaScript  books  and  online  resources  such  as  Webmonkey's  Programming 
JavaScript.  If  you  use  a  JavaScript  method  to  communicate  with  a  Flash  movie,  additional  logic  may  be  necessary  to 
make  sure  issues  such  as  browser  type,  layers  and  such  are  considered  when  implementing  a  script. 


Additional  Information 

Using  variables  in  Flash  can  create  powerful  and  scalable  movies  that  can  change  to  reflect  user  choices,  updates  and 
events.  Writing  expressions  adds  new  levels  of  complexity  to  authoring  in  Flash.  For  more  instructions  on  many  Flash 
scripting  and  design  techniques,  please  visit  the  Flash  Support  Center  and  view  related  TechNotes.  Enter  keyword 
topics  into  the  search  field  to  access  a  wide  variety  of  articles  on  beginning  and  advanced  topics. 


Problems  using  Adobe  Flash  authoring  across  local  area 
networks 


Issue 

When  using  Adobe  Flash  across  a  local  area  network  (LAN)  and  networked  drives/folders,  you  may  experience  any  of 

the  following  problems: 

•  Flash  crashes  while  performing  a  test  movie  on  FLA  files  located  on  a  networked  drive  or  folder. 

•  FLA  files  get  corrupted  when  opening  from  or  saving  to  networked  drives  or  folder. 

•  Flash  does  not  reflect  changes  in  custom  class  after  compiling. 

•  Flash,  Flash  Video  Encoder,  or  Adobe  Media  Encodercrashes  or  corrupts  Flash  Video  (FLV)  files  while  encoding 
source  located  on  networked  drives  or  folder. 

•  Flash  Video  Encoder  or  Adobe  Media  Encoder  crashes  or  corrupts  FLV  files  where  the  output  folder  is  a  networked 
drive  or  folder. 

•  Published  Flash  Player  (SWF)  files  and  projectors  are  unable  to  load  content  located  on  networked  drives  or  folder. 

•  More  than  one  instance  of  a  SWF  or  Projector  on  client  machines  cannot  play  back  FLV  files  located  on  a  networked 
drive  or  folder. 
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Reason 

The  Adobe  Flash  IDE,  FLV  Encoder,  Adobe  Media  Encoderand  Flash  Player  were  not  designed  to  function  across 
LANs. 


Solution 

Use  of  Flash  files  across  local  networks  is  not  supported  in  any  context.  Published  content  should  access  data  through 
a  web  server.  All  file  sources  should  be  opened  and  saved  on  the  local  system.  Using  Flash  in  such  a  scenario  for  project 
collaboration  or  content  deployment  is  highly  discouraged  and  may  corrupt  your  source  files. 

If  you  need  to  work  in  a  collaborative  environment  or  store  source  files  on  a  server,  use  the  project  panel  and/or  a  third- 
party  version  control  system. 


How  to  "park"  a  movie  clip  so  it  can  be  preloaded  and 
reused 


"Parking"  a  movie  clip  is  a  useful  technique.  A  parked  movie  clip  can  sit  invisibly  on  stage  waiting  for  instructions.  This 
allows  the  movie  clip  to  be  preloaded  along  with  the  main  timeline  and  avoids  playback  delays  later  in  the  movie. 

Follow  the  steps  below  to  create  the  movie  clip: 


1 

Create  a  new  movie  clip  using  Insert  >  New  Symbol.  Choose  Movie  Clip 
as  the  symbol's  behavior. 

2 

Double  click  the  keyframe  in  frame  1  and  add  aStopaction  to  the 
frame.  Do  not  place  any  graphics  in  this  frame. 

3 

Add  a  new  keyframe  at  frame  2  (or  at  any  frame  after  frame  1 ).  The 
actual  animation  starts  in  this  keyframe  and  can  contain  graphics  or 
other  movie  clips  For  convenience,  add  a  frame  label  to  this  keyframe 
such  as  "Play". 

4 

Choose  Edit>  Edit  Movie  to  return  to  edit  movie  mode. 

5 

Open  the  Library  and  drag  an  instance  of  this  movie  clip  onto  the 
stage. 

Because  there  are  no  graphics  in  the  first  frame  of  the 
movie  clip  it  will  be  invisible  in  edit  movie  mode.  Also, 
because  the  clip  has  a  Stop  action  on  it's  first  frame 
nothing  will  display  by  default  when  previewing  the 
movie. 

6 

Using  the  Instance  panel,  give  the  movie  clip  an  instance  name. 

To  make  use  of  this  parked  movie  clip  you  use  the  tellTarget  or  with  actions  to  send  the  movie  clip  to  the  frame  that 
contains  the  actual  graphics  or  animation.  For  example,  to  "activate"  the  movie  clip  from  a  button  instance,  attach  the 
following  script  to  the  instance: 


on  (release)  {  tellTarget  ( "instanceName" )  { 


gotoAndPlay  ("Play");  }  } 


Or,  using  the  withaction, 


Last  updated  11/6/2015 


16 


on  (release)  {  with  (instanceName)  {  gotoAndPlay  ("Play");  }  } 


Similarly,  to  "deactivate"  the  parked  clip,  or  send  it  back  to  the  empty  keyframe  in  frame  1 ,  use  a  similar  action  to  send 
the  clip  to  frame  1,  which  contains  no  content. 

Addtional  Information  For  more  information  on  using  the  tellTarget  action  see  How  to  use  the  Tell  Target  action 
(TechNote  13479).  For  more  advanced  information  on  working  with  movie  clips,  please  refer  to  the  Flash  MX 
Application  Development  Center  at  Macromedia's  Designer  and  Developer  Center. 

Note:  Although  a  similar  effect  to  the  one  described  here  can  be  achieved  by  changing  the  _visible  property  of  a  movie 
clip  instance,  this  occasionally  causes  the  movie  clip  to  "flash"  briefly  before  becoming  invisible.  Parking  a  movie  clip 
can  provide  more  consistent  display  performance. 


Multiple  instances  of  movie  clip  with  armature  trace 
only  one  armature 


Issue 

When  multiple  instances  of  a  movie  clip  with  an  armature  are  placed  on  stage,  ActionScript  reports  only  one  armature. 
For  example: 

1  Create  a  movie  clip  with  an  armature. 

2  Drag  three  instances  of  that  clip  to  the  stage. 

3  Add  a  frame  script:  import  fl.ik.*;  trace(IKManager.numArmatures); 

When  you  test  it  using  Test  Movie,  that  trace  returns  "1"  no  matter  how  many  instances  of  that  movie  clip  are  on  stage. 

Solution 

Use  IKArmature.registerElements  to  gain  control  of  the  armature  inside  each  movie  clip 
instance 

To  see  an  example,  download  kb405649.zip,  which  uses  the  following  timeline  script: 
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import  fl.ik.*; 


//  there  is  only  1  armature,  although  there  are  2  instances  of  the  containing 

//  Movieclip  on  stage 

trace (IKManager .numArmatures) ; 

//  Store  a  reference  to  the  armature 

var  arm: IKArmature  =  IKManager . get ArmatureAt ( 0 ) ; 

//  Get  reference  to  the  last  joint  in  the  armature. 

//  We  will  move  this  joint. 

var  last Joint : IKJoint  =  arm. root Joint .getChildAt (0) .getChildAt (0) .getChildAt (0) 

//  Create  the  mover  for  the  last  joint. 

var  mv:IKMover  =  new  IKMover (last Joint ,  last Joint .position) ; 

var  timer:Timer  =  new  Timer(lOO); 

timer . addEventListener (TimerEvent . TIMER,  moveArmatures) ; 

var  pt : Point; 

//  You  can  move  the  armature  within  each  Movieclip,  but 
//  you  need  to  alternate  between  them  when  registering  them 
//  to  a  DisplayObj ect 

function  moveArmatures (evt : TimerEvent ) :void 

{ 

//  move  first  armature 
arm. registerElements (mcl) ; 
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pt  =  new  Point (lastJoint .position. x,  last Joint . position . y  -  5) ; 


mv . moveTo (pt ) ; 

//  move  second  armature 
arm. registerElements (mc2 ) ; 

pt  =  new  Point (lastJoint .position. x,  last Joint . position . y  -  5) ; 
mv . moveTo (pt ) ; 


timer . start ( ) ; 


Additional  information 

Armatures  are  designed  to  work  this  way.  Technically,  no  matter  how  many  instances  of  that  symbol  are  on  stage,  there 
is  still  only  one  armature. 

If  you  target  that  armature  with  ActionScript,  the  code  is  expected  to  affect  that  single  armature  in  every  instance  on 
stage. 

The  result  is  that  there  is  no  intuitive  way  to  target  each  instance's  armature  with  ActionScript. 


Masks  with  interior  shapes  fail  in  ActionScript  3 
documents 


Issue 

Masks  with  interior  shapes  do  not  display  correctly  in  Flash  CS4  Professional.  This  happens  only  in  ActionScript  3.0 
(AS3)  documents. 

Example: 

Note:  Even  though  a  mask  may  not  display  properly,  it  will  still  render  correctly  at  runtime  in  the  final  exported  SWF. 


Reason 

Masks  found  in  AS3  documents,  contrary  to  Flash  CS3  and  ActionScript  2documents,  are  rendered  using  an 
ActionScript  class  that  has  difficulty  displaying  masks  appropriately.  This  is  a  knownissue  in  Flash  CS4  Professional. 
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Solution 

1  Add  a  stroke  within  the  interior  portion  of  the  mask  using  the  Ink  Bottle  Tool. 

2  Convert  this  stroke  to  a  fill,  by  choosing  Modify  >Shape. 

3  Delete  the  fill. 

4  Click  the  lock  for  both  layers  and  the  mask  will  now  display  correctly. 


How  to  make  a  simple  clock  in  Flash 

The  Date  object  introduced  in  Macromedia  Flash  5  makes  it  simple  to  have  a  clock  in  a  Flash  movie.  The  following  steps 
explain  how  to  make  a  simple  clock  that  displays  the  time  in  a  Hours:Minutes:Seconds  am/pm  format.  For  steps  on 
making  a  clock  with  separate  hour,  minute,  and  second  hands  see  Using  the  Date  object:  Building  a  clock  in  Flash  5. 

To  make  a  Flash  clock: 

1  Create  a  new  movie  clip  symbol  (Insert  >  New  Symbol). 

2  Using  the  text  tool,  drag  out  a  text  field  in  this  new  symbol.  This  is  the  text  field  that  will  display  the  current  time. 

3  Select  the  text  field  with  the  Arrow  tool,  and  open  the  Text  Options  panel  (Window  >  Panels  >  Text  Options. 

4  In  the  Text  Options  panel,  choose  Dynamic  Text  from  the  pop-up  menu,  and  give  the  text  field  a  variable  name 
oftime. 

5  Double-click  in  the  first  frame  of  the  symbol  to  open  the  Actions  panel,  and  enter  the  following  script: 

function  getTime  ()  {  var  time  =  new  Dated;  var  hour  =  time . getHours ( ) ;  var  minute  = 

time . getMinutes ( ) ;  var  second  =  time . getSeconds ( ) ;  var  temp  =  " "+ ( (hour>12 )  ?  hour-12  : 
hour);  temp  +=  ((minute<10)  ?  ":0"  :  ":")+minute;  temp  +=  (  (secondclO)  ?  ":0"  :  ":")+second; 
temp  +=  (hour>=12)  ?  "  P.M."  :  "  A.M.";  return  temp;  } 

6  Place  an  instance  of  this  new  symbol  on  the  main  Timeline  of  the  movie. 

7  Select  the  new  movie  clip  instance,  and  open  the  Actions  panel  (Window  >  Actions)  if  it's  not  already  open. 

8  Enter  the  following  script  into  the  Actions  panel: 
onClipEvent  (enterFrame)  {  time  =  getTime ();  } 

9  Test  the  movie  (Control  >  Test  Movie). 

How  it  works 

The  getTime()  function  first  creates  a  new  Date  object,  which  is  used  to  get  the  current  hour,  minutes,  and  seconds. 
Next,  several  ?:  conditional  operators  (a  compact  form  of  anif.else  statement)  are  used  to  determine  the  proper 
formatting  for  the  time  string  (HH:MM:SS  P.M/A.M),  and  assign  the  string  to  the  variable  temp.  For  example,  the 
following  line  of  code  checks  if  the  value  of  hours  is  greater  than  12.  If  so,  12  is  subtracted  from  hour  and  assigned  to 
temp.  Otherwise,  the  value  ofhour  is  assigned  to  temp,  as  is. 

var  temp  =  " " + ( (hour>12 )  ?  hour-12  :  hour); 
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For  minute  and  seconds,  similar  logic  is  used  to  check  if  their  values  are  less  than  10.  If  so,  a  ":0"  is  appended  to  temp 
before  the  minutes  or  seconds.  Otherwise,  the  value  of  minute  or  second  is  appended  to  temp,  as  is.  Finally,  "P.M"  is 
appended  to  temp  if  the  current  hour  is  greater  than  or  equal  to  12,  otherwise  is  appended. 

Note:  If  you  don't  care  to  display  seconds  or  an  A.M./P.M.  modifier  in  the  time  string,  simply  insert  comments  (//)  at 
the  beginning  of  the  function  statements  that  append  that  information  to  temp. 

Finally,  in  step  8,  the  statement  within  the  onClipEvent(enterFrame)  handler  assigns  the  return  value  of  getTime()  to 
time,  the  variable  name  assigned  to  the  text  field  created  in  step  1.  TheenterFrame  event  is  triggered  as  each  frame  of 
the  movie  is  played,  so  the  time  updates  at  each  frame.  This  dependency  on  frame  rate  can  effect  the  clock's  accuracy 
over  long  periods,  but  should  be  fine  for  most  applications,  as  long  as  the  frame  rate  is  12  FPS  or  greater. 

Additional  information 

For  Inversions  of  Flash  Player  5  prior  to5, 0,41,0,  the  getHours()  function  on  Windows  may  return  the  incorrect  hour. 
See  Incorrect  hour  returned  by  getHoursQ  and  getUTCHours()  (TechNote  14964)  for  more  information. 

For  another  example  of  using  movie  clip  events  see  Detecting  a  double-click  in  the  Flash  Player  (TechNote  14461). 


Leading  ampersand  breaks  text  file  parsing  in 
ActionScript  3.0 


Issue 

In  ActionScript  3.0,  you  cannot  use  the  URLVariables  class  to  load  a  text  file  beginning  with  an  ampersand. 


Reason 

In  ActionScript  2.0,  the  LoadVars  class  can  be  used  to  load  a  text  file  beginning  with  this  format:  &name=peter 
Technically  the  leading  ampersand  was  an  incorrect  usage  and  should  have  been  prevented  the  load..  However,  versions 
of  Flash  Player  prior  to  Flash  Player  9  would  silently  ignore  the  ampersand. 

ActionScript  3.0  is  as  standards-compliant  as  possible,  and  the  leading  ampersand  may  be  interpreted  as  an  incorrect 
character  when  loaded  by  the  URLVariables  class.  This  may  prevent  the  text  file  from  parsing  and  may  display  the 
following  error  message: 

Error:  Error  #2101:  The  String  passed  to  URLVariables.decode()  must  be  a  URL-encoded  query  string  containing 
name/value  pairs. 


Solution 

To  resolve  the  parsing  problem  for  ActionScript  3.0,  remove  the  leading  ampersand  from  the  text  file  being  loaded.  For 
example,  while  &name=peter  may  fail,  name=peter  will  parse  correctly. 

Additionally, the  &  character  can  be  used  to  separate  variables  in  a  data  file,  for  example,  first=peter&last=strauss 
However,  any  desired  use  of  the  &  in  the  final  destination  variable  must  be  URL-encoded  using  %26,  for 
example, varl=Bent&var2=Ben%26Jerrys 
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Large  Flash  applications  compile  incorrectly  |  Flash  CS3, 
CS4,  CS5,  CS5.5 


Issue 

Large  Adobe  Flash  CS3,  CS4,  CS5  and  CS5.5  applications  don't  compile.  A  blank  Test  Movie  window  appears  or  the 
SWF  file  is  blank. 

Solution 

Flash  CS5&CS5.5 

The  same  property  as  in  the  CS4  solution  below  can  be  configured  in  the  jvm.ini  file  in  the  location  below: 
<InstallLocation>/Common/First  Run/ActionScript  3.0/jvm.ini 
Open  the  jvm.ini  file  in  your  text  editor  of  choice  and  find  the  following  line: 

-Xmxl28m 

Change  the  128  to  the  suggested  amount  (256  or  more  depending  on  the  application).  Restart  Flash  Professional  to  give 
the  JVM  the  new  starting  amount  of  memory. 

Note:  A  new  warning  dialog  has  been  added  to  CS5.5  for  users  that  encounter  this  issue.  Below  is  what  the  warning 
dialog  will  look  like: 


Clicking  the  OK  button  will  open  the  jvm.ini  file  mentioned  above  in  the  Flash  CS5.5  code  editor  and  allow  the  user  to 
change  the  -Xmxl28m  value.  Note:  You  must  quit  and  restart  Flash  Professional  for  the  changes  to  take  effect. 


Flash  CS4 

Warning!  By  following  the  directions  below,  you  modify  the  Windows  System  Registry.  A  mistake  could  cause  serious 
system  damage,  which  could  require  you  to  reinstall  your  operating  system. 

If  you  are  not  comfortable  editing  the  registry,  get  assistance  from  your  system  administrator  or  another  IT 
professional.  If  you  choose  to  proceed,  first  back  up  your  entire  hard  drive,  and  create  a  Windows  System  Restore  Point. 

An  edit  to  the  "JVM  Max  Heap  Size"  property  in  the  Actionslnspector  category  can  resolve  this  issue. 

(Windows)  Add  a  DWORD  Value  named  "JVM  Max  Heap  Size"  with  a  value  of  "256"  in  the  following  location  in  the 
registry: 

HKEY_CURRENT_USER/ Software / Adobe /Flash  10 /Act ions Inspector 

(Mac  OS)  Add  the  following  entry  to  the  <ActionsInspector>  element  of  the  Flash  CS4  Preferences  file  located  in  the 
/Users/<username>/Library/Preferences  folder: 

<  JVM_Max_He  ap_S  ize>256<  /  JVM_Max_Heap_S  i  z  e  > 

The  number  read  in  is  interpreted  as  megabytes.  The  max  heap  size  defaults  to  128  megs.  Adobe  suggests  an  increase 
to  256  megs  to  resolve  this  issue.  If  this  increase  in  memory  does  not  resolve  the  issue,  continue  to  increase  by  256  megs. 
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Note:  It  is  best  practice  to  not  increase  this  number  by  too  much.  If  you  increase  it  too  much,  Flash  Professional  can 
use  up  all  available  memory  on  the  user's  computer.  Adobe  recommends  that  you  only  raise  the  heap  size  enough  to  fix 
the  problem  at  hand. 


Recommendation  for  CS3  users 

When  designing  a  Flash-based  application,  it  is  best  practice  to  build  it  with  multiple  smaller  objects  which  can  be 
compiled  independently. 

1  Create  custom  components  (SWC).  Learn  more  about  Creating  ActionScript  3  Components. 

2  Use  various  SWF  files  which  can  be  accessed  dynamically.  Learn  more  on  dynamically  loading  SWF  files  using  the 
Loader  Class  (ActionScript  3) 

These  steps  prevent  the  issue  described  in  this  document,  and  also  speed  up  the  compile  time  of  your  application. 


Additional  information 

There  is  no  unique  number  that  qualifies  as  too  much.  This  issue  typically  occurs  in  Flash-based  applications  made  up 
of  thousands  of  lines  of  code,  numerous  large  objects,  or  a  great  number  of  small  classes. 

This  issue  occurs  when  the  JVM  compiler  max  heap  size  isn't  set  high  enough.  Flash  doesn't  have  enough  memory  to 
complete  certain  compile  operations.  This  issue  can  be  solved  in  CS4  by  editing  a  registry  entry  on  Windows  or  by 
editing  a  preference  file  on  a  Macintosh.  CS5  users  can  resolve  this  issue  by  editing  the  jvm.ini  file  as  shown  in  the 
solution  below. 


Issues  addressed  by  the  Flash  CS4  Professional  update  | 

10.0.2 

Adobe  Flash  CS4  Professional  (10.0.2)  addresses  issues  regarding  the  compiling  of  large  project  files  as  well  as  the 
following  key  issues: 

•  Performance  issues  when  dragging  objects  on  stage,  scrubbing  the  timeline,  entering  symbol  edit  mode  in  large 
AS2.0  and  AS  3.0  files. 

•  Performance  issues  when  opening  large  files  or  files  with  many  nested  symbols. 

•  Performance  issues  when  working  in  the  library  such  as  scrolling,  selecting  items  in  the  library,  dragging  item  to 
stage,  editing  symbol  from  library. 

•  Several  crashes  involving  creating  a  text  field  on  stage  and  opening  certain  files. 

•  Graphic  symbol  looping  setting  changes  when  apply  color  effect  to  instance  in  Property  inspector. 

•  gotoAndPlay("framelabel")  compiles  differently  in  CS3  versus  CS4 

•  Put  back  the  JSAPI  that  allows  users  to  publish  FLA  files  without  opening  them  fl.publishDocumentf  flaURI  [, 
publishProfile]  ); 

Bugs  fixed  in  this  release: 

AS2  Doc  Crashes  CS4  when  buttons  not  rendered  correctly 

Auto  Format  beaks  the  code  if  encounters  ++  or  —  with  an  array  inside  if  statement 
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Clicking  through  movie  clip  with  large  preview  takes  long  to  select  in  the  Library  in  AS  3.0  file 

Scrubbing  and  pressing  Enter  to  play  timeline  is  not  smooth,  slower  in  AS3  documents 

Width  and  Height  of  instance  incorrect  after  frame  2  if  apply  tween  to  instance  with  filter 

3D  tools  appear  incorrectly  to  a  child  movie  clip  when  applying  skew  and  rotation  to  the  parent  2d  movie  clip. 

Changing  Width/Height  for  nested  2d>3d  movie  clip  from  Property  Inspector  does  not  work.  After  scrubbing  the  hot 
text ,  it  snaps  back  to  the  original  size. 

Dragging  from  Library  to  Stage  is  slow  in  some  files  in  CS4 

Selecting  items  in  the  library  is  slow  in  CS4 

Scrolling  the  library  (vertical  scroll  bar)  is  slow  compared  to  CS3 

In  a  FLA  with  lots  of  library  items,  double  clicking  a  symbol  "in  the  edit  mode"  hangs  Flash  on  Mac. 

Library  contents  explode  CS4  memory  (CS3  sits  at  75M) 

Performance  issue  with  Stagecore  (AS  3.0  FLA)  -  scrubbing,  moving,  altering  objects. 

Object  visibility  is  compromised  when  created  inside  empty  groups  in  AS  3.0  fla  files. 

Double-clicking  symbol  or  symbol  name  in  library  hangs  Flash;  library  contains  many  items 
Text  with  device  font  disappears  when  it  is  selectable 
Component  parameters  don't  work  for  scenes  greater  than  scene  1 

Selecting  frames  with  text  fields  is  a  lot  slower  if  the  Components  Inspector  panel  is  opened 
Empty  mask  incorrectly  renders  mask  invisible  rather  than  visible 

Crash  when  opening  a  FLA  that  uses  a  font  symbol.  The  font  symbol  name  is  identical  to  the  Postscript  name  of  the 
underlying  font  (and  the  font  is  missing) 

Optimize  a  section  within  a  shape  leaves  gaps  in  the  shape 

Optimize  opening  and  closing  FLA  files,  frame  manipulation  for  FLAs  with  many  frames 

Win  only:  Crash  on  exit  when  the  text  field  is  in  edit  mode  and  clicking  X  button  to  quit  without  save 

Compiler  errors  when  opening  "Air  Settings"  while  ADL  still  running. 

(screens)  Timeline  playhead  can't  scrub  and  jitters  when  playing  anything  that  spans  frames 
gotoAndPlay("framelabel")  compiles  differently  in  CS3  versus  CS4 
Scrubbing  the  timeline  and  selecting  frames  is  much  slower  in  CS4  than  in  CS3 
Crash  when  creating  a  text  object  on  stage  when  there  are  corrupted  fonts 

Graphic  symbol  looping  setting  changes  when  apply  color  effect  to  instance  in  Property  Inspector 

Files  with  lots  of  nested  clips  suffer  from  performance  issue  (file  open)  in  Flash  CS4 

Edit  in  Place  of  2d  objects  which  has  3d  movie  clips  nested  inside  is  not  functioning  correctly. 

Edit  in  place  is  slow  for  complex  instances  in  Flash  Player  10  documents 
Breaking  apart  a  nested  movie  clip  erases  instance  name  of  child  movie  clip 

Efficient  calculation  between  keyframes  so  dragging  is  faster  and  generally  makes  people  happier  if  spans  are  long  and 
complex. 
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AS3  Components  not  compiling  correctly  when  using  the  Component  Definition  dialog 

Windows  Only:  Flash  crashes  when  double  clicking  a  FLA  to  open  while  a  current  FLA  is  opened  with  text  block 
selected 

Can't  interact  with  Flash  because  modal  dialog  is  up  (but  hidden  behind  the  workspace)  when  switching  between 
applications 

From  crash  reporter:  crash  on  Mac  when  double  click  to  enter  symbol  edit  mode  (when  the  black  dotted  rectangle  is 
drawn) 

Mac  IDE  flashes  when  right-clicking  on  Library  after  doing  Test  Movie 

Performance  is  slow  after  double  clicking  movie  clip  to  enter  edit  mode  and  exit 

Setting  an  instance's  width  or  height  to  1  makes  W  and  H  hot  text  unusable  in  the  vertical  PI. 

Plot  text  in  the  Vertical  PI  for  X,  Y,  W,  H  displays  only  one  decimal  point  while  edit  field  displays  two. 

Export  image:  Dimension  values  in  Export  dialog  and  Vertical  PI  do  not  match  which  is  misleading  to  user. 

Crash  when  selecting  text  field  on  stage  with  many  fonts  on  user's  system. 

Text  Property  Inspector  is  stuck  and  some  controls  on  the  PI  are  not  drawn  with  certain  fonts  on  user's  system 

The  JSAPI  that  allows  users  to  publish  FLA  files  without  opening  them  was  inadvertently  removed  when  the  Project 
Panel  was  deprecated. 

"Export  classes  in  frame"  behavior  is  different  in  CS3  than  in  CS4 
Dragging  large  nested  symbol  from  library  to  stage  hangs  Flash 

Dragging  from  Library  to  Stage  slow  on  subsequent  drag  or  after  scrubbing  the  timeline 

Scrubbing  and  pressing  Enter  to  play  timeline  is  not  smooth,  slower  in  AS3  documents 

Width  and  Height  of  instance  incorrect  after  frame  2  if  tween  applied  to  instance  with  filter 

Large  amounts  of  text  nested  in  a  symbol  causes  performance  problems  in  non-AS3  documents 

Play  back  in  authoring  is  not  smooth  (playhead  skips  frames).  You  cannot  stop  it  when  hitting  enter.  It  eventually  hangs 
and  takes  long  to  respond  (both  AS  2.0  and  AS  3.0) 

Performance  Creating  Exported  Symbol  when  the  classpath  contains  lots  of  files  and  folder 
Create  ease,  undo  after  first  edit  removes  ease 

Selecting  and  deselecting  raw  shape  after  convert  to  symbol  spikes  memory  and/or  crashes 
FLA  crash  on  open  when  fonts  loaded 

Mac  only:  User  input  resets  to  previous  setting  when  attempting  to  change  any  value  in  Vertical  PI  input  area 
Accessing  a  Windows  SWF  after  it  has  been  moved  or  deleted  crashes  Flash 
Crashing  when  reopening  FLA  after  canceling  publish 
Crash  in  test  movie  when  running  a  file  with  video  and  filters 
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Imported  bitmaps  display  as  red  boxes  when  tested  in 
Device  Central 


Issue 

When  using  Device  Central  to  test  Flash  Lite  1.x  content  created  in  Adobe  Flash  CS3  Professional,  images  compressed 
with  Photo  (JPEG)  compression  may  display  as  red  boxes.  At  the  same  time  the  Output  window  will  display  the  error: 

"FLERR:  Bad  Image  Data  Error". 


Reason 

This  issue  is  the  result  of  changes  in  JPEG  compression  in  Adobe  Flash  CS3  Professional.  This  issue  will  affect  any 
bitmap  which  uses  Photo  (JPEG)  compression  and  other  than  the  default  JPEG  compression  specified  in  the  Flash  tab 
of  Publish  Settings. 

To  be  more  specific,  this  issue  affects  any  imported  bitmap  for  which  Use  Document  Default  Quality  has  been 
deselected,  or  any  imported  JPEG  for  which  Use  Imported  JPEG  Data  has  been  deselected. 


Solution 

Please  use  the  following  methods  when  targeting  Flash  Lite  1.x  and  using  bitmaps  that  require  Photo  (JPEG) 

compression: 

•  When  importing  JPG  files  for  use  in  Flash  Lite  1.x  files,  use  the  images  imported  JPG  data: 

1  Compress  the  JPG  file  before  importing  it  into  Flash  CS3  Professional,  using  an  image  editing  program  such  as 
Adobe  Photoshop  or  Fireworks.  This  gives  you  control  over  the  appearance  of  the  individual  image,  separate 
from  the  documents  default  JPEG  compression  quality. 

2  Import  the  file  into  Flash. 

3  In  the  Library,  select  the  image.  Using  the  Library's  Panel  Menu  (or  right-click),  open  the  Bitmap  Properties  for 
that  image.  Select  Use  Imported  JPEG  Data.  This  will  keep  the  bitmap  in  the  final  SWF  file  at  its  smallest  size, 
using  the  original  image  compression  settings.  (This  option  is  checked  by  default  for  imported  JPG  files). 

4  Instead  of  option  3,  use  the  Lossless  (PNG/GIF)  Compression  setting  (creating  a  larger  SWF  file). 

•  For  all  other  imported  images  (PNG,  BMP,  GIF,  bitmap  content  generated  from  Adobe  Illustrator,  Photoshop 

or  Fireworks  import): 

1  In  the  Library,  select  the  image.  Using  the  Library's  Panel  Menu  (or  right-click),  open  the  Bitmap  Properties  for 
that  image.  Select  Photo  (JPEG)  Compression. 

2  Check  Use  Document  Default  Quality  to  create  the  smallest  SWF  file.  (This  option  is  unchecked  by  default  for 
imported  bitmaps  other  than  JPG,  PNG  or  GIF). 

3  Instead  of  option  2,  use  the  Lossless  (PNG/GIF)  Compression  setting  (creating  a  larger  SWF  file). 
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Flex  Builder  mm.cfg  modification  may  cause  redraw 
issues  with  Flash  CS4  Professional 


Issue 

If  you  run  Adobe  Flex  Builder  3  and  Adobe  Flash  CS4  Professional  on  the  same  machine,  you  may  experience  odd 
redraw  and  debugger  issues  in  Flash  authoring. 

Note:  This  issue  may  effect  both  Flash  CS3  and  Flash  CS4  Professional. 


Reason 

When  you  launch  Flex  Builder  3  it  modifies  the  mm.cfg  file  to  use  a  Flex  debug  profiling  agent  SWF  file.  When  Flex 
Builder  3  quits  it  is  supposed  to  remove  this  entry  from  mm.cfg,  restoring  it  to  the  original  state.  However,  if  Flex 
Builder  is  forced  to  quit  unexpectedly  or  hangs,  this  entry  can  be  abandonedin  themm.cfg  file.  This  can  have  adverse 
effects  when  authoring  in  Flash  CS4  Professional. 


Solution 

A  permanent  solution  will  be  added  in  a  future  version  of  Flex  Builder. 

In  the  meantime,  there  are  two  possible  workarounds: 

Manually  remove  the  line  from  mm.cfg: 

1  Open  mm.cfg  in  Notepad,  Textedit  of  the  text  editor  of  your  choice,  and  manually  remove  the  line  added  by  Flex 
Builder.  To  find  the  location  of  mm.cfg,  see  "Configure  the  debugger  version  of  Flash  Player"  (TechNote  kb403009). 
The  line  added  by  Flex  Builder  will  look  similar  to  this:PreloadSwf=C:/Users/<username>/Documents/Flex  Builder 
3/.metadata/.plugins/com.adobe.flash.profiler/ProfilerAgent.swf?host=localhost&port=9999 

2  Delete  that  line. 

3  Save  the  file. 

Replace  mm.cfg: 

If  you  have  a  custom  or  edited  version  of  mm.cfg,  you  can  replace  the  entire  file  with  a  backup  copy. 

1  Find  the  location  of  mm.cfg  (see  "Configure  the  debugger  version  of  Flash  Player"  (TechNote  kb403009). 

2  Delete  the  file. 

3  Replace  it  with  your  original  mm.cfg  in  the  same  location. 

4  Relaunch  Flash  CS4  Professional. 


Adobe  Flash  Publish  keyboard  shortcut  (Shift+FI  2)  is 
used  by  Mac  OS  X  1 0.4 
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Issue 

Using  the  keyboard  shortcut  of  Shift+F12  to  publish  from  Adobe  Flash  causes  Macintosh  OS  X  Dashboard  to  launch. 
For  example: 

1  Launch  Flash  8  on  OS  10.4  (Tiger). 

2  Create  a  new  FLA  document. 

3  Press  Shift+F12  to  publish  the  document. 

The  Tiger  Dashboard  application  appears  and  the  Flash  SWF  is  not  published. 

Reason 

The  Mac  OS  X  Dashboard  keyboard  shortcut  conflicts  with  the  Publish  keyboard  shortcut  Adobe  Flash  uses. 

Ref.  (133051) 

Solution 

Creating  a  custom  Keyboard  Shortcut  will  resolve  this  issue. 

1  Choose  Edit  >  Keyboard  Shortcuts 

2  Duplicate  the  existing  keyboard  shortcut  set  using  the  Duplicate  Set  button 

3  Name  the  new  Keyboard  Shortcut  set 

4  Expand  the  File  tree  and  select  "Publish" 

5  Select  and  remove  the  existing  keyboard  shortcut  for  Edit  >  Publish 

6  Choose  +  to  add  a  new  shortcut 

7  Press  the  desired  new  keyboard  shortcut  (for  example,  Command  +  Shift  +  F12) 

8  Choose  OK  to  close  the  Keyboard  Shorcut  dialog  box  and  make  the  new  custom  set  the  currently  assigned  set. 

For  complete  information,  see  "Customizing  keyboard  shortcuts"  in  Adobe  Flash  Help. 


Flash  Player  10,  Action  Script  3:  Loader.unloadAndStop 

History 

The  Loader.unloadAndStop  feature  was  added  to  Action  Script  3's  API  to  automate  a  process  that  was  previously 
manual  when  using  Loader.unload. 

Though  Loader.unload  removes  the  child  of  the  Loader  object,  the  unloaded  object  will  still  run  in  the  background 
until  it  is  actually  disposed  of  by  the  garbage  collector.  Since  the  garbage  collector  does  not  dispose  of  objects  that  are 
referred  to,  the  "unloaded"  content  could  perhaps  never  be  removed  (for  example,  event  listeners  could  reference  the 
object). 

Example:  A  SWF  file  that  has  a  music  track  is  loaded  into  an  application.  Later,  the  SWF  is  unloaded  using 
Loader.unload().  Though  the  SWF  will  be  removed  from  the  screen,  the  music  will  still  be  heard. 

SOLUTION 

Loader.unloadAndStop  is  a  new  addition  to  Action  Script  3's  API.  It  helps  developers  to  correctly  stop  and  unload 
loaded  content  using  the  Loader.load/loadBytes  APIs. 
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Loader. unlo ad AndStop  is  very  similar  to  Loader.unload.  However,  it  adds  one  more  step.  After  the  "unload"  event  is 
dispatched  to  the  Loaderlnfo  class,  Flash  Player  recursively  attempts  to  stop  and  clear  as  many  objects  as  possible 
(Sounds,  NetStreams,  EventListeners,  etc.)  within  the  loaded  SWF.  This  feature  is  especially  useful  when  unloading 
unknown  3rd  party  content. 

Example 

import  flash. display. Loader 

import  flash.net .URLRequest 
import  flash. events . Event 


var  myLoader : Loader  =  new  Loader (); 


myLoader . contentLoaderlnf o . addEventListener (Event . COMPLETE, function (e : Event) { 


addChild (myLoader) ; 


}); 


myLoader . load (new  URLRequest ( " item2 . swf " ) ) ; 

btnUnload . addEventListener (MouseEvent . CLICK, function ( ) { 

//  Calling  this  method  will  unload  and  recursively  stop  the  content  of  the  movie. 
myLoader . unloadAndStop ( ) ; 

}>; 


Flash  OBJECT  and  EMBED  tag  attributes 

This  document  is  the  target  of  a  link  in  the  Flash  Lite  4  Porting  Guide.  Before  you  archive  or  unpublish,  contact 
Learning  Resources. 

This  document  lists  the  attributes  of  the  OBJECT  and  EMBED  tags  used  to  publish  SWF  (Flash-enabled)  content  in 
HTML  pages  for  display  in  web  browsers.  The  attributes  allow  you  to  specify  certain  parameters  that  control  the  details 
of  how  and  where  Flash  Player  displays  the  SWF  file  in  the  browser. 

Information  about  including  Flash-enabled  (SWF  file)  content  within  web  pages  is  also  available  in  the  TechNote 
OBJECT  tag  syntax  |  Flash  (tn_4150). 


Required  attributes 

The  following  attributes  are  required  within  the  OBJECT  and  EMBED  tags  when  adding  a  SWF  file  to  an  HTML  page. 
The  Publish  command  in  Flash  Professional  creates  HTML  files  with  the  required  attributes  specified  for  you. 

Note:  Values  in  brackets  and  italics  indicate  that  the  developer  chooses  the  value. 


Last  updated  1 1 76/201  5 


29 


Required  for  both  OBJECT  and  EMBED: 

•  width  -  Specifies  the  width  of  the  SWF  content  in  either  pixels  or  percentage  of  browser  window. 

•  height  -  Specifies  the  height  of  the  SWF  content  in  either  pixels  or  percentage  of  browser  window. 

Required  for  OBJECT  tag  only: 

•  classid  -  Identifies  the  ActiveX  control  for  the  browser.  See  example  code  in  OBJECT  tag  syntax  |  Flash  (tn_4150) 
for  the  correct  value. 

•  codebase  -  Identifies  the  location  of  the  Flash  Player  ActiveX  control  so  that  the  browser  can  automatically 
download  it  if  it  is  not  already  installed.  See  example  code  in  OBJECT  tag  syntax  |  Flash  (tn_4150)  for  the  correct 
value. 

•  movie  (param)  -  Specifies  the  source  location  (URL)  of  the  SWF  file  to  load. 

Required  for  EMBED  tag  only 

•  src  -  Specifies  the  source  location  (URL)  of  the  SWF  file  to  load. 

•  pluginspage  -  Identifies  the  location  of  the  Flash  Player  plug-in  so  that  the  user  can  download  it  if  it  is  not  already 
installed. 


Optional  attributes 

The  following  attributes  are  optional  when  defining  the  OBJECT  and  EMBED  tags.  For  OBJECT,  all  attributes  are 

defined  in  param  tags  unless  otherwise  specified: 

•  id  (attribute  for  OBJECT  tag)  and  name  (attribute  for  EMBED  tag)  -  SWF  file  identifier.  Identifies  the  SWF  file  to 
the  web  browser,  allowing  browser  scripting  languages  (for  example,  JavaScript)  to  reference  the  SWF  content.  For 
cross-browser  compatibility,  make  sure  that  the  id  and  name  are  set  to  the  same  value. 

•  play  -  Possible  values:  true,  false.  Specifies  whether  a  timeline-based  SWF  file  begins  playing  immediately  on 
loading  in  the  browser.  If  this  attribute  is  omitted,  the  default  value  is  true. 

•  loop  -  Possible  values:  true,  false.  Specifies  whether  a  timeline-based  SWF  file  repeats  indefinitely  or  stops  when  it 
reaches  the  last  frame.  If  this  attribute  is  omitted,  the  default  value  is  true. 

•  menu  -  Possible  values:  true,  false.  Specifies  if  movie  playback  controls  are  available  in  the  Flash  Player  context 
menu. 

•  true  displays  a  full  menu  that  provides  expanded  movie  playback  controls  (for  example,  Zoom,  Quality,  Play, 
Loop,  Rewind,  Forward,  Back). 

•  false  displays  a  menu  that  hides  movie  playback  controls  (for  example,  Zoom,  Quality,  Play,  Loop,  Rewind, 
Forward,  Back).  This  attribute  is  useful  for  SWF  content  that  does  not  rely  on  the  Timeline,  such  as  content 
controlled  entirely  by  ActionScript.  The  short  menu  includes  "Settings"  and  "About  Flash  Player"  menu  items. 

•  quality  -  Possible  values:  low,  autolow,  autohigh,  medium,  high,  best.  Specifies  the  display  list  Stage  rendering 
quality.  Setting  the  Stage.quality  property  via  ActionScript  overrides  this  value. 

•  low  favors  playback  speed  over  appearance  and  never  uses  anti-aliasing. 

•  autolow  emphasizes  speed  at  first  but  improves  appearance  whenever  possible.  Playback  begins  with  anti¬ 
aliasing  turned  off.  If  Flash  Player  detects  that  the  processor  can  handle  it,  anti-aliasing  is  turned  on. 

•  autohigh  emphasizes  playback  speed  and  appearance  equally  at  first  but  sacrifices  appearance  for  playback  speed 
if  necessary.  Playback  begins  with  anti-aliasing  turned  on.  If  the  actual  frame  rate  drops  below  the  specified 
frame  rate,  anti-aliasing  is  turned  off  to  improve  playback  speed.  Use  this  setting  to  emulate  the  View  >  Antialias 
setting  in  Flash  Professional. 
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•  medium  applies  some  anti-aliasing  and  does  not  smooth  bitmaps.  It  produces  a  better  quality  than  the  Low 
setting,  but  lower  quality  than  the  High  setting. 

•  high  favors  appearance  over  playback  speed  and  always  applies  anti-aliasing.  If  the  movie  does  not  contain 
animation,  bitmaps  are  smoothed;  if  the  movie  has  animation,  bitmaps  are  not  smoothed. 

•  best  provides  the  best  display  quality  and  does  not  consider  playback  speed.  All  output  is  anti-aliased  and  all 
bitmaps  are  smoothed. 

•  scale  -  Possible  values:  showall,  noborder,  exactfit,  noscale.  Specifies  how  Flash  Player  scales  SWF  content  to  fit  the 
pixel  area  specified  by  the  OBJECT  or  EMBED  tag. 

•  default  (Show  all)  makes  the  entire  SWF  file  visible  in  the  specified  area  without  distortion,  while  maintaining 
the  original  aspect  ratio  of  the  movie.  Borders  can  appear  on  two  sides  of  the  movie. 

•  noborder  scales  the  SWF  file  to  fill  the  specified  area,  while  maintaining  the  original  aspect  ratio  of  the  file.  Flash 
Player  can  crop  the  content,  but  no  distortion  occurs. 

•  exactfit  makes  the  entire  SWF  file  visible  in  the  specified  area  without  trying  to  preserve  the  original  aspect  ratio. 
Distortion  can  occur. 

•  noscale  prevents  the  SWF  file  from  scaling  to  fit  the  area  of  the  OBJECT  or  EMBED  tag.  Cropping  can  occur. 

•  align  (attribute  for  Object)  -  Possible  values:  1,  t,  r. 

•  Default  centers  the  movie  in  the  browser  window  and  crops  edges  if  the  browser  window  is  smaller  than  the 
movie. 

•  1  (left),  r  (right),  and  t  (top)  align  the  movie  along  the  corresponding  edge  of  the  browser  window  and  crop  the 
remaining  three  sides  as  needed. 

•  salign  -  Possible  values:  1,  t,  r,  tl,  tr. 

•  1,  r,  and  t  align  the  movie  along  the  left,  right,  or  top  edge  of  the  browser  window  and  crop  the  remaining  sides 
as  needed. 

•  tl  and  tr  align  the  movie  to  the  upper-left  and  top  upper-corner  of  the  browser  window  and  crop  the  bottom  and 
remaining  side  as  necessary. 

•  wmode  -  Possible  values:  window,  direct,  opaque,  transparent,  gpu.  Sets  the  Window  Mode  property  of  the  SWF  file 
for  transparency,  layering,  positioning,  and  rendering  in  the  browser.  If  this  attribute  is  omitted,  the  default  value  is 
"window".  For  more  information,  see  Using  Window  Mode  (wmode)  values  below. 

•  window  -  The  SWF  content  plays  in  its  own  rectangle  ("window")  on  a  web  page.  The  browser  determines  how 
the  SWF  content  is  layered  against  other  HTML  elements.  With  this  value,  you  cannot  explicitly  specify  if  SWF 
content  appears  above  or  below  other  HTML  elements  on  the  page. 

•  direct  -  Use  direct  to  path  rendering.  This  attribute  bypasses  compositing  in  the  screen  buffer  and  renders  the 
SWF  content  directly  to  the  screen.  This  wmode  value  is  recommended  to  provide  the  best  performance  for 
content  playback.  It  enables  hardware  accelerated  presentation  of  SWF  content  that  uses  Stage  Video  or  Stage  3D. 

•  opaque  -  The  SWF  content  is  layered  together  with  other  HTML  elements  on  the  page.  The  SWF  file  is  opaque 
and  hides  everything  layered  behind  it  on  the  page.  This  option  reduces  playback  performance  compared  to 
wmode=window  or  wmode=direct. 

•  transparent  -  The  SWF  content  is  layered  together  with  other  HTML  elements  on  the  page.  The  SWF  file 
background  color  (Stage  color)  is  transparent.  HTML  elements  beneath  the  SWF  file  are  visible  through  any 
transparent  areas  of  the  SWF,  with  alpha  blending.  This  option  reduces  playback  performance  compared  to 
wmode=window  or  wmode=direct. 
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•  gpu  -  Use  additional  hardware  acceleration  on  some  Internet-connected  TVs  and  mobile  devices.  In  contrast  to 
other  wmode  values,  pixel  fidelity  for  display  list  graphics  is  not  guaranteed.  Otherwise,  this  value  is  similar  to 
wmode=direct. 

•  bgcolor  -  [hexadecimal  RGB  value]  in  the  format  #RRGGBB.  Specifies  the  background  color  of  the  SWF  content. 
Use  this  attribute  to  override  the  background  color  (Stage  color)  setting  specified  in  the  SWF  file.  (This  attribute 
does  not  affect  the  background  color  of  the  HTML  page.) 

•  base  -  [base  directory]  or  [URL].  Specifies  the  base  directory  or  URL  used  to  resolve  all  relative  path  statements  in 
the  SWF  file.  This  attribute  is  helpful  when  your  SWF  file  is  kept  in  a  different  directory  from  your  other  files. 

•  allowFullScreen  -  Possible  values:  true  or  false.  Setting  this  value  to  true  allows  the  SWF  file  to  enter  full  screen 
mode  via  ActionScript.  For  more  information,  see  Exploring  full  screen  mode  in  Flash  Player.  If  this  attribute  is 
omitted,  the  default  value  is  false. 

•  fullScreenAspectRatio  -  Possible  values:  portrait  or  landscape.  Used  to  control  how  full  screen  SWF  content 
appears  on  mobile  devices  that  support  automatic  screen  rotation,  such  as  phones  and  tablets.  If  this  attribute  is 
specified,  Flash  Player  uses  the  specified  screen  orientation  (portrait  or  landscape)  when  the  SWF  is  viewed  in  full 
screen  mode.  It  doesn't  matter  how  the  device  is  oriented.  If  this  attribute  is  not  specified,  orientation  of  content  in 
full  screen  mode  follows  the  screen  orientation  used  by  the  browser. 

•  flashvars  -  Variables,  defined  as  a  string  of  key=value  pairs,  that  are  passed  to  the  SWF  file. 

•  Use  flashvars  to  specify  root-level  variables  in  the  SWF  file.  The  format  of  the  string  is  a  set  of  key=value 
combinations  separated  by  the  character. 

•  Browsers  support  string  sizes  of  up  to  64  KB  (65535  bytes)  in  length. 

•  For  more  information  on  using  flashvars,  see  Using  FlashVars  to  pass  variables  to  a  SWF  (tn_16417). 

•  browserzoom  -  The  following  OBJECT  and  EMBED  tags  are  available  in  Flash  Player  to  change  the  the  size  of  Flash 
content  in  response  to  change  in  browser  zoom  factor: 

•  scale:  turn  on  the  browser  zoom  factor  behavior 

•  noscale:  turn  off  the  browser  zoom  factor  behavior 


Using  Window  Mode  (wmode)  values 

Developers  can  set  the  Window  Mode  (wmode)  property  of  the  SWF  content  to  control  layering  and  transparency  of 
the  content  in  the  browser.  Regardless  of  the  wmode  value,  Flash  Player  displays  content  viewed  in  full  screen  mode 
using  direct  path  rendering.  Using  direct  path  rendering  enables  hardware  accelerated  presentation  capabilities  such  as 
Stage  Video  and  Stage  3D. 

To  deliver  the  highest  performance  playback  of  Flash-enabled  content  in  the  browser,  use  wmode=direct.  This 
attribute  enables  hardware  accelerated  presentation  capabilities,  including  Stage  Video  and  Stage  3D.  Avoid  overlapping 
the  SWF  content  with  HTML  elements  (for  example,  HTML-based  pop-up  menus)  intended  to  appear  above  the  SWF 
file.  Explicit  layering  control  is  only  supported  with  some  modern  browsers  (see  table  below).  In  other  browsers,  the 
SWF  content  always  appears  above  other  HTML  elements. 

If  you  require  explicit  layering  control,  transparency,  or  HTML  elements  that  float  above  SWF  content,  use 

wmode=opaque  or  wmode=transparent.  You  can  then  control  layering  in  relationship  to  other  elements  on  the  page 
through  HTML.  However,  these  "windowless"  modes  reduce  playback  performance  compared  to  wmode=window  (the 
default)  and  wmode=direct. 
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Use  case 

Recommended  wmode 

Best  performance,  including  support  for  hardware  accelerated  Stage 
Video  and  Stage  3D. 

wmode=direct 

Requires  overlapping  HTML  elements  to  appear  on  top  of  SWF 
content,  transparency,  or  explicit  layering  control  relative  to  HTML 
elements  (across  all  browsers). 

wmode=opaque  or  wmode=transparent 

Browser  support  for  Window  Mode  (wmode)  values 

Different  browsers  rely  on  different  approaches  for  rendering  web  page  content  and  handles  wmode  values  differently. 
The  table  above  summarizes  when  to  use  different  wmodes.  The  matrix  below  details  the  specific  behaviors  you  can 
expect  in  each  browser. 


Wmode 

Benefits 

IE  6,  7, 
and  8 

Win 

IE  9  Win 

Firefox 

Win 

Chrome 

Win 

Firefox  3 

Mac 

(OSX 

10.5  and 
later) 

Firefox  4 

Mac 

(OSX 

10.6  and 
later) 

Safari  3 
(OSX 

10.5) 

Safari  4 
(OSX 

10.6  and 
later) 

Chrome 

Mac 

(OSX 

10.5) 

Chrome 

Mac 

(OSX 

10.6  and 
later) 

window 

Broadest 

accessibil 

ity 

support 

-/-/A 

-/-/A 

-/-/A 

-/-/A 

77- 

177- 

77- 

177- 

77- 

VI-1- 

transpare 

nt 

Transpare 
ncy  and 
alpha 
blending 

over 

HTML 

elements 
supporte 
d.  HTML 
elements 

can 

overlap 

SWF 

content. 

Explicit 

layering 

control 

(all 

browsers) 

VI-1- 

177- 

L/7- 

177- 

177- 

177- 

177- 

177- 

177- 

177- 
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opaque 

HTML 

elements 

can 

overlap 

SWF 

content. 

Explicit 

layering 

control 

(all 

browsers) 

IV-/- 

L /-/- 

LI-1- 

LI-1- 

U-h 

Ll-I- 

Ll-I- 

Ll-I- 

Ll-I- 

Ll-I- 

direct 

Best 

performa 

nee. 

Hardware 

accelerat 

ed 

presentat 

ion, 

including 
Stage 
Video 
and  Stage 
3D  (all 
browsers) 

-/H/A 

L/H /- 

-/H/A 

-/H/A 

-Ml- 

L/H/- 

-Ml- 

L/H/- 

-IWI- 

L/H/- 

gpu 

Additiona 

1 

hardware 

accelerati 

on  on 

some 

Internet 

connecte 

d TVs  and 

mobile 

devices. 

-/H/A 

L/H/- 

-/H/A 

-/H/A 

-/H /- 

L/H/- 

-/»/- 

L/H/- 

-Ml- 

L/H/- 

L  =  HTML  layering  is  supported.  HTML  elements  can  overlap  SWF  content.  Supports  explicit  control  of  layering  in 
relation  to  other  HTML  elements.  H  =  Hardware  accelerated  presentation  is  supported,  including  Stage  Video  and  Stage 
3D.  A  =  Accessibility  is  supported. 


Related  Information 

•  OBJECT  tag  syntax 

•  SWF  file  ignores  stacking  order,  plays  on  top  of  DHTML  layers 

Adobe  FlashLiteBundler.exe  location  for  Flash  CS3 
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Issue 

Adobe  Flash  Lite  Sound  Bundler  application  (FlashLiteBundler.exe)  is  not  included  with  Adobe  Flash  CS3 
Professional.  This  application  is  described  in  theFlash  CS3  documentation,  but  is  not  installed  in  the  expected  location. 


Reason 

The  Adobe  Flash  Lite  sound  bundler  is  still  available,  but  much  of  its  functionality  has  been  replaced  by  new  features 
in  Flash  Lite  2. 


Solution 

If  you  would  like  to  use  Adobe  FlashLiteBundler.exe,  it  is  available  in  the  Flash  Lite  1.1  Content  Development  Kit 
(CDK).  FlashLiteBundler.exe  will  still  work  with  Flash  Lite  2  and  3  as  described  in  the  documention. 

To  access  FlashLiteBundler.exe,  download  the  Flash  Lite  1.1  CDK.  Unzip  the  package.  FlashLitebundler.exe  should  be 
in:  Flash_Lite_l.l_CDK\Flash_Lite_authoring_updater\Flash  Lite  Bundler\ 

Adobe  Flash  CS3  Slider  component  slider  thumb  is 
misaligned 


Issue 

When  using  the  Slider  component  in  Adobe  Flash  CS3  with  ActionScript  3.0,  you  may  find  that  when  the  direction  of 
the  Slider  instance  is  vertical  and  its  minimum  value  is  non- zero,  the  position  of  the  slider  thumb  is  offset  from  the 
slider  track. 


Reason 

This  is  the  result  of  the  Slider  component  evaluating  an  incorrect  location  for  the  slider  thumb  graphics  for  vertical 
sliders. 


Solution 

To  correct  this  issue,  you  will  need  to  edit  the  Slider  component's  source  code  and  keep  a  modified  version  of  that 
source  code  within  the  classpath  of  your  movie. 

The  source  class  file  for  the  Slider  component  for  a  default  installation  of  Adobe  Flash  CS3  is  located  in  the  following 
folder: 

Windows:  C:\Program  Files\Adobe\ Adobe  Flash  CS3\[lang]\Configuration\Component  Source\ActionScript 
3.0\User  Interface\fl\controls\Slider.as 

Mac  OS  X:  Macintosh  HD/ Applications/ Adobe  Flash  CS3/[lang]/Configuration/Component  Source/ ActionScript 
3.0/User  Interface/fl/controls/Slider.as 

Where  [lang]  would  be  a  two  character  code  representing  your  language  (en  is  for  English). 
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Copy  Slider.as  into  a  folder  within  the  classpath  of  your  Flash  source  FLA  maintaining  the  fl/controls  folder  structure 
as  it  represents  the  package  path  for  the  Slider  class.  By  default,  the  Classes  folder  within  the  ActionScript  3.0 
configuration  of  the  Adobe  Flash  CS3  installation  is  within  each  FLA's  classpath,  otherwise  you  could  use  one  of  your 
own.  In  using  the  Classes  folder,  Slider.as  would  be  saved  as: 

Windows:  C:\Program  Files\Adobe\ Adobe  Flash  CS3\[lang]\Configuration\ActionScript 
3.0\Classes\fl\controls\Slider.as 

Mac  OS  X:  Macintosh  HD/Applications/Adobe  Flash  CS3/[lang]/Configuration/ ActionScript 
3.0/Classes/fl/controls/Slider.as 

Note:  It  is  not  recommended  that  you  edit  Slider.as  within  its  current  location  adding  that  location  to  your  project's 
classpath. 

Open  the  new  copy  of  Slider.as  now  located  within  the  fl/controls  folder  in  your  classpath.  In  that  file  change  the 
following  positionThumb  function  on  line  662  from 

protected  function  positionThumb (): void  {  thumb. x  =  ( (_direction  ==  SliderDirection. VERTICAL) 

?  (maximum-minimum- value)  :  (value -minimum) )/ (maximum-minimum) * (_width) ;  } 

to 

protected  function  positionThumb (): void  {  thumb. x  =  ( (_direction  ==  SliderDirection. VERTICAL) 

?  (maximum-minimum- (value -minimum) )  :  (value-minimum) )/ (maximum-minimum) * (_width) ;  } 

Save  it  and  then  test  your  movie. 

The  live  preview  in  Flash  will  not  show  the  correction  but  your  movie  should  no  longer  exhibit  this  behavior  during  its 
playback. 


Flash  CS3  Professional  Crashes  Changing  Publish 
Settings  on  OS  X  Leopard 


Issue 

In  Flash  Professional  CS3on  an  OS  X  Leopard  Mac,  when  you  choose  only  "Windows  Projector"  and/or  "Macintosh 
Projector"  in  the  Publish  Settings  dialog, Flashwill  quit.  If  the  file  is  saved  with  just  these  two  options  selected,  you  will 
be  unable  to  change  the  publish  settings.  If  you  attempt  to  deselect  the  two  projector  options,  then  Flash  will  quit. 


Reason 

This  occurs  when  only  the  Formats  tab  is  visible  in  Publish  Settings  (it  is  only  possible  to  create  this  condition  when 
selecting  just  the  two  projector  options.  All  other  publish  options  must  be  deselected).  This  is  a  known  issue  which  will 
be  fully  addressed  in  the  next  version  of  Flash. 


Solution 

To  work  around  this  issue,  install  the  following  Adobe-created  WindowSWF  Panel.  This  panel  can  then  be  used  to 
control  Publish  Settings  without  having  to  open  or  display  the  actual  Publish  Settings  dialog: 
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To  install: 

1  Download  LeopardPublishSettings.zip. 

2  Unzip  the  file.  This  will  give  you  a  folder  named  "LeopardPublishSettings." 

3  From  the  LeopardPublishSettings  folder,  copy  PublishFormats.swf  and  ChangePublishFormats.ejsf  to: 
/Volume/Users/<user>/Library/ Application  Support/ Adobe/Flash  CS3/en/Configuration/WindowSWF 

4  Re-launch  Flash  CS3  Professional. 

To  use: 

1  Choose  Window  >  Other  Panels  >  PublishFormats  to  open  the  PublishFormats  panel. 

2  Open  the  FLA  file  you  wish  to  update. 

3  Click  Get  Current  Publish  Formats  to  see  which  formats  are  currently  targeted  by  the  FLA. 

4  Select  the  options  for  the  formats  to  which  you  want  to  publish.  Click  Update  Publish  Formats  to  specify  the 
formats.Note:  You  can  still  open  the  Publish  Settings  dialog  and  change  each  format's  publish  settings  as  you  like. 
However,  do  not  add  or  remove  formats  using  the  Publish  Settings  dialog.  Use  this  PublishFormats  WindowSWF 
Panel  instead. 


Empty  text  fields  lose  their  device  font  mapping  when 
opened  in  Flash  CS4  Professional 


Issue 

An  empty  dynamic  or  input  text  field  using  device  fonts  is  assigned  a  different  font  when  opened  in  Flash  CS4 
Professional.  This  issue  only  affects  empty  text  fields  that  use  device  fonts  such  as  '_sans'  or  ^typewriter'. 

For  example,  an  empty  input  text  field  using  '_sans'  changes  to  the  most  recently  selected  device  font  when  opened  in 
Flash  CS4  Professional. 


Reason 

This  is  a  known  issue  in  Flash  CS4  Professional.  It  will  be  addressed  in  a  future  version  of  Flash. 


Solution 

To  work  around  this  issue,  do  the  following: 

1  In  Flash  CS3  Professional  or  earlier  version,  enter  at  least  one  character  of  text  in  the  field.  Save  the  FLA,  then  open 
in  Flash  CS4  Professional. 

2  In  Flash  CS4  Professional,  change  the  font  after  opening  the  file. 
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How  to  duplicate  a  movie  clip  in  random  locations 

To  place  Movie  Clips  in  random  positions  on  the  screen,  you  will  use  the  Duplicate  Movie  Clip,  Set  Variable  and  Set 
Property  statements,  and  the  Random  function,  all  of  which  are  new  to  Flash  4.  This  tutorial  assumes  that  you  have 
read  the  "Creating  Interactivity"  section  of  the  Flash  Help  which  can  be  found  in  either  the  print  manual  or  the  HTML 
Help. 


There  are  at  least  two  ways  to  create  this  effect:  You  can  have  the  clips  appear  when  the  viewer  hits  a  Button,  or  they  can 
appear  when  a  certain  frame  in  the  movie  is  reachedaespecially  in  a  loop.  We'll  go  through  both  of  these. 

First,  a  primer  on  the  statements  we'll  use: 

•  Duplicate  Movie  Clip  creates  a  Movie  Clip  identical  to  one  you  specify.  You  must  specify  the  target  path  of  the 
original  (How  To  Use  Tell  Target ),  an  instance  name  for  the  new  duplicate,  and  a  layer  depth  for  the  new  duplicate. 

•  Set  Variable  assigns  a  value  to  a  variable,  whether  the  variable  is  new  or  preexisting.  You  must  specify  the  name  and 
value  of  the  variable. 

•  Set  Property  can  be  used  to  change  certain  properties  of  a  Movie  Clip  instance,  such  as  X  position,  Y  position, 
Visibility  or  Alpha  value.  You  must  specify  the  name  of  the  property  to  be  changed,  the  target  path  of  the  Movie  Clip 
instance  whose  property  is  to  be  changed,  and  a  new  value  for  the  property. 

•  Random  is  a  function  that  generates  a  random  number  between  0  and  one  less  than  the  number  you  specify.  For 
example, Random  (10)  generates  the  number  0,  9,  or  something  in  between. 

To  place  Movie  Clips  in  random  positions  on  the  stage  when  the  user  clicks  a  Button,  follow  these  steps: 

1  Place  your  Button  and  Movie  Clip  on  the  stage,  and  give  the  clip  an  instance  name  by  selecting  the  Movie  Clip  and 
choosing  Modify> Instance.  In  this  example,  the  spinning  flower  is  namedspinny . 

2  Double-click  on  the  Button  to  bring  up  the  Instance  Properties  dialog  box. 

3  Select  the  Actions  tab. 

4  From  the  plus  menu,  select  Duplicate/Remove  Movie  Clip.  Fill  in  the  dialog  boxes  as  follows: 

•  Action:  Duplicate  Movie  Clip 

•  Target:/ spinny  (Or  your  Movie  Clip  instance's  name).  If  you  wish,  you  can  use  the  Target  Editor  to  choose  the 
target  visually.  The  tab  to  the  right  of  the  box  should  be  set  to  "String  Literal." 

•  New  Name:  A  generic  Movie  Clip  name,  such  as"MC",  concatenated  with  a  variable  using  an  ampersand.  For 
example,  "MC"  &  var  See  finished  product .  The  tab  should  be  set  to  "Expression." 

•  Depth:  A  variable  name,  in  the  example  the  variable  is  named  var.  The  variable  for  "New  Name"  and  "Depth" 
should  be  the  same.  This  way  we  only  need  one  variable  in  one  Set  Variable  statement.  The  tab  should  be  set  to 
"Expression." 

5  From  the  plus  menu,  select  Set  Property.  Fill  in  the  dialog  boxes  as  follows: 

•  Set:  X  Position 

•  Target:  This  is  the  same  name  you  specified  in  "New  Name"  above.  The  tab  should  be  set  to  "Expression,"  just  as 
with  "New  Name." 

•  Value:Random(350).  Thus,  the  X  Position  of  the  duplicate  Clip  is  set  to  a  random  integer  between  0  and  349. 
Random  is  a  function,  so  the  tab  must  be  set  to  "Expression." 

6  Repeat  step  5  for  the  new  Y  Position. 
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7  From  the  plus  menu,  select  Set  Variable  and  fill  in  the  dialog  boxes  as  follows: 

•  Variable:var  (Or  a  variable  name  of  your  choice,  as  long  as  it  is  the  same  as  the  one  you  put  in  "Depth,"  and  put 
on  the  end  of  the  name  you  wrote  in  "New  Name"  in  "Duplicate  Movie"  above.) 

•  Value:var  +  1.  This  increments  the  var  variable  so  that  the  next  time  the  Button  is  clicked,  the  next  Movie  Clip 
has  a  different  name  and  is  placed  in  a  different  layer. 

8  Click  OK. 

Finished  Product 

After  you've  done  the  steps  above,  the  action  script  in  the  Button's  Instance  Properties  box  should  look  like  this: 

On  (Release)  Duplicate  Movie  Clip  ("/spinny",  "MC"&var,  var)  Set  Property  ("MC"&var,  X 
Position)  =  random(350)  Set  Property  ("MC'&var,  Y  Position)  =  random(350)  Set  Variable:  "var" 

=  var+1  End  On 

Note:  You  can  add  as  many  Set  Property  statements  as  you  like.  In  the  Flower  example  shown  above,  I  also  included  the 
statement  below  to  set  the  Alpha  property  of  each  new  Movie  Clip  to  a  value  between  10  and  100: 

Set  Property  ("MC"&var,  Alpha)  =  Random ( 91 ) +10 

Placing  Movie  Clips  when  the  Movie  reaches  a  certain  frame 

Simply  follow  the  same  instructions  as  above,  but  place  the  actions  in  the  Frame  Properties  box  by  double-clicking  a 
keyframe  where  the  action  should  occur.  Also,  the  script  does  not  need  theOn  (Release)  and  End  On  actions  when 
placed  in  a  frame. 

Note:  To  create  a  "Clear"  Button  that  removes  all  the  duplicate  Movie  Clips  from  the  stage,  use  the  Loop  action.  The 
action  script  on  the  "Clear"  button  looks  like  this: 

On  (Release)  Loop  While  (count  <=  var)  Remove  Movie  Clip  ("MC"  &amp;  count)  Set  Variable: 
"count"  =  count  +  1  End  Loop  Set  Variable:  "var"  =  "0"  Set  Variable:  "count"  =  "0"  End  On 

Q/A 

Why  does  the  name  of  the  duplicate  clip  have  to  be  that  expression,  instead  of  something  friendly? 

The  expression  "MC"&var  evaluates  as  "The  literal  letters  MC,  concatenated  (stuck  together  with)  the  value  of  the 
variable  var."  By  naming  the  duplicate  clip  this  way,  the  Button  will  keep  creating  new  duplicates  with  new  names  (MCI, 
MC2,  etc.)  as  long  as  the  viewer  keeps  clicking  the  Button. 

Why  does  the  duplicate's  level  have  to  be  set  asvar? 

Since  the  value  of  var  increments  with  each  Button  click,  this  ensures  that  each  clip  is  put  on  its  own  layer.  If  the  depth 
were  set  as  a  number,  each  clip  would  replace  the  previous  one,  since  they  would  both  occupy  the  same  layer.  Try  it  and 
see. 

Why  was  350  chosen  as  the  range  for  Random? 

It  didn't  have  to  be,  but  since  the  Set  Property  statement  defines  X  and  Y  position  in  pixels,  and  this  Flash  Player  Movie 
is  350  pixels  high  and  350  pixels  wide,  this  range  ensured  that  the  clips  would  be  placed  on  the  screen. 

Additional  information 

For  additional  information  about  advanced  interactivity  in  Flash,  please  refer  to  How  To  Use  Tell  Target  (TechNote 
13479). 
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Differences  between  the  Equality  operator  (==)  and  the 
Assignment  operator  (=) 

In  Macromedia  Flash  5,  the  assignment  operator  (=)  and  the  equality  operator  (==)  appear  to  be  similar  but  are  used 
for  completely  different  reasons. 

The  assignment  operator  (=)  is  used  to  assign  a  value  to  a  variable,  element  of  an  array,  or  property  of  an  object.  Here 
are  a  few  examples  of  using  the  assignment  operator: 

//  Set  a  variable  to  a  value,  var  userName  =  "Jack";  //  Set  an  element  of  an  array  to  a  value. 
namesArray [3 ]  =  "Jack";  //  Set  a  property  of  a  object  to  a  value.  nameClip ,_visible  =  FALSE; 

The  equality  operator  (==)  is  used  to  compare  two  values  or  expressions.  It  is  used  to  compare  numbers,  strings, 
Boolean  values,  variables,  objects,  arrays,  or  functions.  The  result  is  TRUE  if  the  expressions  are  equal  and  FALSE 
otherwise.  How  items  are  compared  depends  on  their  data  type: 

•  Numbers,  strings,  and  Boolean  values  are  compared  byvalue,  and  are  considered  equal  if  they  have  the  same  value. 
For  instance,  two  strings  are  equal  if  they  have  the  same  number  of  characters. 

•  Variables,  objects,  arrays,  and  functions  are  compared  byreference.  Two  variables  are  equal  if  they  refer  to  the  same 
object,  array,  or  function.  Two  separate  arrays  are  never  considered  equal,  even  if  they  have  the  same  number  of 
elements. 

For  example,  in  the  following  expression,  the  value  ofuserName  and  the  string  "Jack"  are  the  same  and  expression 
evaluates  to  TRUE: 

(userName  ==  "Jack");  //  TRUE.  //  However...  (userName  ==  "jack");  //  FALSE. 

The  second  expression  evaluates  to  FALSE  because  "Jack"  is  not  the  same  string  value  as  "jack". 

However,  when  comparing  two  variables,  array,  objects,  or  functions,  an  equality  expression  will  evaluate  to  TRUE  only 
if  the  items  being  compared  point  to  the  same  reference.  For  example,  consider  the  following: 

var  userName  =  "Jack";  var  user  =  "Jack"; 

Although  the  two  variables  contain  the  same  value  the  variables  themselves  are  not  equal,  since  they  point  to  different 
references.  For  example: 

(userName  ==  user);  //  FALSE  //  However...  (eval (userName)  ==  eval (user) ) ;  //  TRUE 

The  second  expression  is  TRUE  because  the  two  variables  were  first  evaluated  (using  the  eval  function)  and  their 
values,  rather  than  their  references,  are  being  compared. 

A  practical  example  of  using  the  equality  operator 

The  equality  operator  is  often  used  in  the  following  manner  to  check  if  a  movie  has  completely  loaded: 
if  (_f ramesloaded  ==  _totalframes)  {  gotoAndPlay  (3);  }  else  {  gotoAndPlay  (1);  } 

Additional  Information 

For  more  details  on  preloading  a  movie  please  refer  to  How  to  create  movies  that  download  before  playing 
(TechNotel2588). 
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Creating  a  mask  that  follows  a  motion  guide 

Note:  The  information  in  this  TechNote  is  specific  to  Macromedia  Flash  5  and  earlier.  Macromedia  Flash  MX  adds  the 
ability  to  use  animated  or  scripted  movie  clips  as  masks.  The  techniques  in  this  technote  will  continue  to  work  in 
Macromedia  Flash  MX,  however  it  would  be  simpler  to  use  the  new  features  of  Macromedia  Flash  MX.  For  complete 
details  refer  to  the  Macromedia  Flash  MX  documentation. 

Motion  Tweening  Masks  in  Flash  5  and  earlier  versions 

Many  interesting  effects  can  be  created  using  masks  together  with  motion  tweens.  This  is  a  great  way  to  get  an  animated 
mask.  Some  users  want  the  tweened  mask  to  follow  a  motion  guide.  But  since  a  layer  can't  be  both  a  mask  layer  and  a 
guide  layer,  this  is  not  possible  using  a  single  SWF. 

However,  this  effect  can  be  achieved  using  two  Flash  movies.  In  one  movie,  a  motion  tween  is  created  that  follows  a 
guide  layer.  This  movie  is  then  exported  as  an  SWF  and  imported  into  the  second  movie.  In  the  second  movie,  the  layer 
that  contains  the  imported  SWF  is  set  to  be  a  mask  layer.  Finally,  the  object  to  be  masked  is  placed  in  a  masked  layer 
under  the  imported  tween. 

Prerequisites:  This  tutorial  assumes  that  you  are  familiar  with  the  basic  concepts  of  masks,  as  discussed  in  Creating 
masks  and  creating  motion  guides,  as  covered  in  How  to  add  and  use  a  motion  guide  (TechNote  14133). 

Download  the  source  files  for  this  example  mask_follow_guide.zip  (17K) 

To  have  a  mask  follow  a  motion  guide  do  the  following: 

1  In  the  first  movie,  create  a  motion  tween  that  follows  a  guide  layer.  This  animation  will  be  used  as  the  mask  in  the 
second  movie.  The  shape  of  the  tweened  object  needs  to  be  the  shape  that  you  want  the  mask  to  be. 

2  Publish,  or  export,  the  first  movie  as  an  SWF. 

3  Import  the  SWF  exported  above  into  another  Flash  movie  using  the  File  >  Import  command.  This  will  bring  in  the 
SWF  as  a  frame  by  frame  animation  on  one  layer,  which  will  be  used  as  the  mask  layer. 

4  Change  the  imported  layer's  property  to  Mask  and  add  the  material  that  you  want  masked  to  a  layer  below  the  mask 
layer. 


Additional  Information 

If  your  motion  tween  does  not  follow  the  guide  layers  see,  Motion  path  animation  doesn't  follow  path  (TechNote  4104). 
If  you  encounter  problems  with  using  a  movie  clip  in  the  mask  layer  see  Problems  using  movie  clips  in  mask  layers 
(TechNote  14264). 


Creating  advanced  buttons 

This  document  introduces  you  to  more  design  possibilities  in  the  construction  of  Flash  Buttons.  For  more  resources  on 
performing  specific  actions  with  buttons,  see  Additional  Information  at  the  bottom  of  this  document. 

Prerequisites 

To  get  the  most  out  of  this  TechNote,  an  understanding  of  creating  basic  buttons  is  required.  We  recommend  doing  the 
"Buttons"  Lesson  within  Flash  (Available  from  the  Help  menu).  More  button  resources  are  available  in  Additional 
Information  at  the  bottom  of  this  document. 


Last  updated  1 1 76/201  5 


41 


Contents 

•  Button  Hit  states 

•  Invisible  buttons 

•  Buttons  with  "animated" states 

•  Rollover  in  one  area  of  the  movie  affects  another  area  of  the  movie 
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Button  Hit  states 

Hit  states  are  important  to  understand  when  designing  a  complex  button.  Its  shape  and  area  represent  the  active  area 
of  the  button.  Become  familiar  and  comfortable  with  the  Hit  state. 

Experimenting  with  the  Hit  state 

1  Introduce  a  button  from  the  Common  Libraries  onto  the  Stage.  Edit  the  button. 

2  Highlight  the  frame  in  the  button's  Hit  state,  and  insert  a  Key  frame.  Test  this  behavior  in  a  movie. 

3  Resize  the  object  in  the  Hit  state  dramatically,  and  test. 

4  Delete  the  Keyframe  in  the  Hit  State.  Test  this. 

5  Notice  how  these  changes  affect  your  button  cursor,  and  the  Up,  Over  and  Down  states  that  you  see  when  the  button 
is  enabled. 

Invisible  buttons 

The  Up,  Over  and  Down  states  of  a  button  maybe  left  empty.  If  these  states  are  empty,  the  Hit  state  must  then  be  defined 
(contain  content). 

When  the  Up  state  of  the  button  is  empty  or  'invisible',  the  button  is  represented  on  the  Stage  by  a  blue  shape  equivalent 
to  the  content  in  the  next  Keyframe  within  the  button.  This  blue  shape  will  not  be  visible  in  your  final  movie.  See  the 
Example  to  see  how  this  works. 

Buttons  with  "animated"  states 

To  make  animated  buttons  in  Flash,  place  a  Movie  Clip  in  the  button  state  that  is  to  be  animated. 

Create  an  animated  button 

1  Create  a  movie  clip  for  each  state  of  the  button  that  you  want  animated. 

2  Create  the  button. 

3  Place  the  movie  clips  in  the  button  states)  to  be  animated. 

4  Place  the  button  on  the  stage. 

See  the  Example  to  see  how  this  works. 

Note:  Movie  clips  cannot  be  tested  in  the  Flash  editor.  You  will  need  to  do  a  Control  >  Test  Movie  or  export  it  as  a  .swf 
file  to  test. 

Rollove  in  one  area  of  the  movie  affects  another  area  of  the  movie 

To  create  this  effect,  move  the  Hit  state  elements  to  a  different  area  of  the  Stage  than  elements  in  the  Over  state  of  the 
button.  This  will  work  for  simple  rollover  effects.  The  active  area  of  the  button,  will  then  be  located  in  a  different  area 
onstage  than  the  rollover  effect.  See  the  Example  to  see  how  this  works 

Example 
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Note:  The  Macromedia  Flash  Player  is  required  to  see  this  example. 

Download  Windows  source  file  advanced_biittons.zip  (17  K) 

Download  Macintosh  source  file  advanced_biittons.sit  (18  K) 

Note:  Flash  4  or  later  is  required  to  open  the  source  file. 

Additional  information 

For  more  information  on  basic  buttons,  see  the  Using  Flash  manual. 

To  learn  how  to  assign  an  action  to  a  Button,  do  the  Buttons  lesson  inside  Flash.  See  the  Using  Flash  manual  for  more 
information  on  Mouse  Events  and  assigning  actions  to  Buttons.  See  the  ActionScript  Reference  for  more  advanced 
information  on  what  actions  can  be  performed. 

To  create  a  simple  animated  menu,  see  How  to  create  a  pop-up  menu  in  Flash  (TechNote  14363). 

To  create  a  link  to  an  e-mail  address,  see  How  to  create  a  button  that  will  send  e-mail  messages  (TechNote  14072). 

To  make  a  button  for  clearing  fields  in  a  Flash  form,  see  How  to  create  a  reset  button  (TechNote  15541). 


Create  a  simple  sound  toggle  |  Flash 

This  TechNote  explains  how  to  create  a  simple  sound  toggle  control  like  the  one  shown  in  the  sample  movie  below 
(requires  Flash  Player  5  or  later).  The  basic  technique  involves  inserting  a  streaming  sound  inside  a  movie  clip.  The 
sound  can  be  controlled  with  simple  ActionScript  2.0  Play  and  Stop  actions  attached  to  buttons.  Because  the  sound  is 
set  to  Stream,  the  sound  starts  up  where  it  was  last  stopped. 

Before  using  this  TechNote,  be  sure  that  you  are  working  with  a  FLA  file  with  the  Script  setting  set  to  ActionScript  2.0 
in  the  Document  properties. 


Create  the  sound  movie  clip 

1  Choose  Insert  >  New  Symbol  and  choose  Movie  Clip  as  the  symbol's  behavior.  Give  the  movie  clip  a  name  of  your 
choosing. 

2  Choose  Import  from  the  File  menu  and  browse  to  the  folder  containing  the  sound  file  you  want  to  play  and  import 
it  into  the  movie's  Library. 

3  In  the  first  frame  of  the  movie  clip,  insert  add  a  Stop  action. 

4  Select  frame  2  and  choose  Insert  >  Blank  Keyframe.  Then  drag  the  imported  sound  symbol  from  the  Library 
(Window  >  Library)  to  the  stage  of  the  movie  clip. 

5  Add  the  frame  label  "start"  where  the  sound  begins  in  frame  2. 

6  With  frame  2  still  selected,  open  the  Sound  panel  (Window  >  Panels  >  Sound),  and  choose  Stream  from  the  Sync 
pop-up  menu.Note:  Event  sounds  don't  work  with  this  method. 

7  Insert  frames  into  the  movie  clip's  timeline  until  the  waveform  for  the  sound  disappears,  as  shown  below. 
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8  At  the  frame  where  the  waveform  ends,  insert  a  keyframe  and  add  the  following  action  to  the  frame:gotoAndPlay 
("start");  This  action  causes  the  playhead  to  return  to  the  beginning  of  the  sound  when  it's  complete.  If  you'd  prefer 
the  sound  to  not  loop,  insert  a  Stop  action  on  this  frame  rather  than  thegotoAndPlay  action. 

9  Return  to  Edit  Movie  mode  (Edit  >  Edit  Movie)  and  drag  an  instance  of  this  clip  from  the  Library  to  the  stage.  Give 
the  clip  an  instance  name  of  "me"  in  the  Instance  panel  (Window  >  Panels>  Instance). 


Add  buttons  to  control  the  sound  clip 

1  Add  two  buttons  to  the  stage  to  stop  and  start  the  sound.  This  example  uses  the  gel  Right  and  gel  Stop  buttons  from 
the  Buttons  common  Library  (Window  >  Common  Libraries  >  Buttons>  (circle)  VCR  Button  Set). 

2  Select  the  button  you  want  to  cause  the  sound  to  play  and  open  the  Actions  panel  (Window  >  Actions).  Add  the 
following  ActionScript  to  the  button: 

on  (release)  { 
with  (me) 

{ 

play  ()  ; 

} 

} 

This  step  causes  the  movie  clip  containing  the  sound  to  start  playing,  which  starts  the  sound. 

3  Select  the  button  you  want  to  cause  the  sound  to  stop.  Open  the  Actions  panel  (Window  >  Actions).  Add  the 
following  ActionScript  to  the  button: 

on  (release)  { 
with  (me) 

{ 

stop  ()  ; 

} 

} 

This  button  causes  the  movie  clip  containing  the  sound  to  stop  playing,  which  stops  the  sound. 


4  Test  the  movie  by  choosing  Control  >  Test  Movie.  If  the  sound  doesn't  start  or  stop  on  command,  make  sure  that 
the  instance  name  you've  assigned  to  the  sound  clip  is  "me."  Also  make  sure  that  the  sound's  Sync  property  in  the 
Sound  panel  is  set  to  Stream  and  not  Event. 


Create  scrolling  text  |  Flash  CS3  and  earlier 

What's  covered 

•  Scrolling  text  in  Flash  CS3  Professional 

•  Scrolling  text  in  Flash  8 

•  Scrolling  text  in  Flash  MX  2004 

Scrolling  text  in  Flash  CS3  Professional 
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There  are  several  ways  to  create  scrolling  text  in  Flash  CS3  Professional: 

•  Use  the  ActionScript  3.0  TextArea  component  included  with  Flash  CS3  Professional.  If  the  TextArea  is  set  to 
editable,  then  as  soon  as  enough  lines  are  entered,  the  UlScrollbar  component  will  automatically  appear  on  the  right 
side  of  the  TextArea.  Vertical  scrolling  can  be  enabled/disabled  only  by  using  the  verticalScrollPolicy  method  of 
fl.controls.TextArea. 

•  Make  dynamic  or  input  text  fields  scrollable  by  using  menu  commands  or  the  text  field  handle  (see  Flash  CS3 
Professional  Help). 

•  Add  a  ScrollBar  component  to  a  text  field  to  make  it  scroll.  This  is  useful  in  cases  where  the  overhead  of  the  TextArea 
component  isn't  needed 

To  create  a  scrolling  text  field  in  Flash  CS3  Professional,  do  the  following: 

1  Using  the  Text  tool,  create  an  instance  of  an  input  text  field  on  the  Stage. 

2  In  the  Properties  Panel,  assign  the  instance  the  following  properties:  Text  type:  "Input  text"  Instance  name:  "scroller" 
Line  type:  "Multiline" 


Note:  Depending  on  design  it  may  be  helpful  to  also  select  Show  Borders  Around  Text. 

3  Open  the  Components  panel. 

4  In  the  Tools  panel,  verify  that  Snap  To  Objects  is  on. 

5  Drag  the  UlScrollbar  component,  dropping  it  to  the  left  or  right  side  of  the  text  field  instance.  It  should  snap  to  the 
text  field.  UlScrollbar  can  also  be  created  dynamically  via  ActionScript.Note:  At  this  point  notice  that  selecting  the 
scrollbar,  then  the  Parameters  tab  of  the  Properties  inspector  will  show  you  that  the  snapping  automatically  sets  the 
scrollTargetName  property  to  the  name  of  the  text  field.  In  Flash  Player  this  is  how  the  scrollbar  controls  the  text 
field. 

6  Choose  Control  >  Test  Movie.  Enter  enough  text  to  fill  the  text  field  and  the  scrollbar  should  become  enabled. 


Scrolling  text  in  Flash  8 

To  create  a  scrolling  TextArea  component  in  Flash  8,  do  the  following: 

1  Drag  a  TextArea  component  from  the  Components  panel  to  the  Stage. 

2  In  the  Property  inspector,  enter  an  instance  name. 

3  In  the  Property  inspector  Parameter's  tab,  set  Editable  and  Wordwrap  to  true. 

4  Test  the  movie.  When  enough  lines  are  entered  to  fill  the  component,  the  scrollbar  will  automatically  appear. 

To  make  standard  dynamic  text  fields  scrolling  using  ActionScript  in  Flash  8,  see  Flash  8  Help. 

Scrolling  text  in  Flash  MX  2004 

Flash  MX  2004  did  not  ship  with  a  scroll  bar  component.  The  recommended  solution  for  creating  scrolling  text  in  Flash 
MX  2004  is  to  use  the  TextArea  component  or  to  use  ActionScript  to  scroll  the  content  of  a  text  field.  The  TextArea 
component  is  the  preferred  method  because  it  includes  scrollbars  with  an  automatic  show/hide  feature. 

To  create  a  scrolling  TextArea  component,  do  the  following: 

1  Drag  a  TextArea  component  from  the  Components  panel  to  the  Stage. 

2  In  the  Property  inspector,  enter  an  instance  name. 
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3  In  the  Property  inspector,  set  parameters  as  you  wish.  However,  leave  the  text  parameter  blank,  the  editable 
parameter  set  to  true,  and  the  password  parameter  set  to  false. 

4  Test  the  movie  and  try  entering  text  into  TextArea  component.  When  you  have  entered  enough  text  the  scroll  bar 
will  automatically  appear  in  the  field. 

To  use  ActionScript  to  scroll  a  text  field,  do  the  following: 

1  Select  the  Text  tool  and  create  a  text  field  on  the  stage.  Leave  room  on  the  stage  for  buttons  that  can  be  used  to  scroll 
the  text  up  and  down. 

2  In  the  Property  inspector,  select  Input  Text  as  the  type  of  text  field  and  Multiline  as  the  line  type.  You  may  want  to 
select  the  Show  Border  option  so  the  text  field  will  be  visible  when  you  test  the  application. 

3  In  the  Property  inspector,  enter  the  instance  name  my_txt  for  the  text  field. 

4  Drag  two  button  components  to  the  stage  and  enter  an  instance  name  buttonl,  and  button2  respectively. 

5  Place  the  following  code  on  button l:on( click) {  _root.my_txt.scroll  ++;  //  This  will  scroll  the  text  up  1  line  } 

6  Place  the  following  code  on  button2:on(click){  _root.my_txt.scroll— ;  //  This  will  scroll  the  text  down  1  line  } 

7  Test  the  movie  and  enter  text  into  the  text  field.  Once  there  is  enough  text  to  scroll,  you  can  use  the  buttons  to  scroll 
up  and  down. 


Create  pop-up  menus  |  Flash 

This  TechNote  walks  you  through  making  a  pop-up  menu  in  Flash,  similar  to  the  one  shown  in  the  example  movie 
below. 

The  menu  smart  clip  that  ships  with  Macromedia  Flash  5  provides  another  way  to  add  pop-up  menus  to  Flash  movies. 
See  Customizing  the  Flash  5  Menu  Smart  Clip  (TechNote  15140)  for  details. 

Note:  Movie  shown  in  small  scale. 

Download  Windows  source  file  popup_menu.fla.zip  (8K) 

Download  Macintosh  source  file  popup_menu.fla.sea.hqx  (8K) 

Make  the  movie 

Follow  all  of  the  steps  exactly,  and  refer  to  the  images  when  necessary.  You  may  wish  to  print  out  these  instructions  for 
easy  reference. 

How  this  movie  functions: 

1  Each  Menu  has  its  own  segment  of  the  movie's  timeline.  This  avoids  conflicts  between  any  submenu  items. 

2  The  rollover  actions  are  performed  by  invisible  buttons.  Each  menu  item  has  its  own  invisible  rollover  button. 

3  The  rollover  button  is  a  large  button  the  size  of  the  entire  stage  area  with  a  cutout  for  the  menu  items. 

4  The  menu  items  and  hidden  buttons  cannot  overlap  or  they  may  not  function. 

The  steps  are  broken  down  into  the  following  sections: 
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Create  layers 

1  Create  four  layers,  by  choosing  Insert  >  Layer  from  the  Flash  menu  until  you  have  a  total  of  four  layers. 

2  Name  the  top  layer  "  Actions/Labels". 

3  Name  the  second  layer  from  the  top  "Top  level  buttons". 

4  Name  the  third  layer  from  the  top  "Submenu  buttons". 

5  Name  the  bottom  layer  "  Invisible  buttons". 

Set  up  layer:  Actions/Labels: 

1  Highlight  frame  1  of  the  Actions/Labels  layer. 

2  Choose  Modify  >  Frame. 

3  In  the  Label  tab,  label  the  frame  "START"  (without  quotes). 

4  Select  the  Actions  tab  and  assign  a  Stop  action  by  clicking  the  plus  "+"  sign  and  select  "Stop".  Click  OK. 

5  Highlight  frame  10  of  the  Actions/Labels  layer. 

6  Choose  Insert  >  Keyframe  (or  use  F6  on  your  keyboard)  to  insert  a  keyframe. 

7  Choose  Modify  >  Frame. 

8  In  the  Label  tab,  label  the  frame  "MENU  1". 

9  In  the  Actions  tab,  assign  a  "Stop"  action.  Click  OK. 

1 0  Highlight  frame  20  the  Actions/Labels  layer  and  press  F6  to  insert  a  keyframe. 

1 1  With  this  frame  highlighted,  select  Modify  >  Frame. 

1 2  In  the  Label  tab,  label  the  frame  "MENU  2". 

1 3  In  the  Actions  tab,  assign  a  "Stop"  action.  Click  OK. 

14  Highlight  frame  30  of  the  Actions/Labels  layer  and  press  F6  to  insert  a  keyframe. 

1 5  Lock  this  layer  by  clicking  the  padlock  icon. 

Create  the  menu's  button: 

1  Choose  "Insert  >  New  Symbol".  Name  it  "Button",  choosing  Button  as  the  behavior.  Click  OK. 

2  Choose  the  Rectangle  tool,  and  select  a  medium  green-colored  fill. 

3  In  the  center  of  the  stage,  draw  a  rectangle  similar  to  the  one  in  the  example  shown,  about  50  pixels  high  by  200  pixels 
wide. 

4  Highlight  the  "Over"  frame,  and  press  F6  to  insert  a  keyframe  here. 

5  Choose  the  Paint  Bucket  tool  and  select  a  dark  green  color  from  the  palette. 

6  Apply  the  Paint  Bucket  to  the  rectangle,  changing  it  to  dark  green.  This  will  make  the  button  turn  dark  green  while 
the  cursor  is  over  it,  in  the  finished  movie. 

7  Highlight  the  "Down"  Frame,  and  press  F6  to  insert  a  keyframe. 

8  Choose  light  green  as  the  Paint  Bucket  color,  and  apply  it  to  the  green  rectangle.  This  will  make  the  button  turn  light 
green  while  the  button  is  pressed  in  the  finished  movie. 
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9  Choose  Edit  >  Edit  Movie  to  return  to  the  main  timeline. 

Create  the  Top  Level  menu: 

1  Open  this  movie's  Library  by  choosing  Window  >  Library. 

2  Find  "Button"  in  the  Library,  and  drag  a  Button  from  the  Library  window  to  the  upper  left  of  the  stage.  Drag  from 
the  thumbnail  preview  of  the  Button  in  the  window. 

3  Drag  a  second  instance  of  Button  from  the  Library  window  to  the  upper  right  of  the  stage. 

4  Line  the  two  buttons  up  across  the  top  of  the  stage,  about  100  pixels  apart. 

5  Choose  the  Text  Tool.  For  the  font,  choose  Arial,  24  point,  White,  Bold. 

6  Create  a  text  block  next  to  the  first  button  that  says  "MENU  1". 

7  Do  the  same  as  above  for  the  second  button,  and  type  "MENU  2". 

8  Using  the  Arrow  tool,  select  and  center  the  text  on  the  buttons. 

9  Highlight  the  MENU  1  button  on  the  Stage. 

1 0  Choose  Modify  >  Instance.  In  the  Actions  tab,  click  the  "+"  sign,  and  choose  "OnMouseEvent"  and  on  the  right, 
choose  "Roll  Over". 

1 1  Click  the  "+"  again,  and  choose  "Goto".  On  the  right,  choose  "Label",  selecting  "MENU  1"  from  the  pop-up  menu. 
Click  OK. 

1 2  Highlight  the  MENU  2  button  on  the  Stage. 

1 3  Choose  Modify  >  Instance.  In  the  Actions  tab,  click  the "+"  sign,  choosing  "OnMouseEvent"  and  on  the  right,  choose 
"Roll  Over". 

14  Click  the "+"  again,  and  choose  "Goto".  On  the  right,  choose  "Label",  selecting  "MENU  2"  from  the  pop-up  menu. 
Click  OK. 

1 5  Select  frame  20  of  the  Top  level  buttons  layer  and  press  F6  to  insert  a  keyframe. 

1 6  Lock  this  layer. 

Create  the  Submenu  items 

1  Highlight  frame  10  of  the  Submenu  buttons  layer  and  press  F6  to  insert  a  keyframe. 

2  From  the  Library  window,  drag  an  instance  of  Button  on  the  stage  below  MENU  1. 

3  Using  the  Arrow  tool,  center  it  about  20  pixels  below  the  MENU  1  button. 

4  Drag  another  instance  of  the  Button  on  the  stage,  centering  it  about  20  pixels  below  the  last  button. 

5  Choose  the  Text  Tool. 

6  On  the  button  below  MENU  1,  create  type  that  says  "SUBMENU  la". 

7  On  the  button  below  SUBMENU  la,  create  type  that  says  "SUBMENU  lb". 

8  Use  the  Arrow  tool  to  center  the  text  on  the  buttons. 

9  Highlight  frame  20  of  the  Submenu  Buttons  layer. 

1 0  With  frame  20  selected,  choose  Insert  >  Blank  Keyframe,  or  press  F7  on  your  keyboard.Note:  You  must  insert  a 
BLANK  keyframe  here  or  the  example  will  not  work. 
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1 1  Drag  an  instance  of  the  Button  from  the  Library  on  the  stage  below  MENU  2. 

1 2  Using  the  Arrow  tool,  center  it  about  20  pixels  below  the  MENU  2  button. 

1 3  Drag  another  instance  of  the  Button  on  the  stage,  centering  it  about  20  pixels  below  the  last  button. 

1 4  Choose  the  Text  tool. 

1 5  On  the  button  below  MENU  2,  create  type  that  says  "SUBMENU  2a". 

1 6  On  the  button  below  SUBMENU  2a,  create  type  that  says  "SUBMENU  2b". 

1 7  Use  the  Arrow  tool  to  center  the  text  on  the  buttons. 

1 8  Lock  this  Layer. 

Creating  the  invisible  buttons 

Invisible  button  1: 

1  Highlight  frame  10  of  the  Invisible  buttons  layer. 

2  Press  F6  to  insert  a  keyframe. 

3  Select  the  Rectangle  tool,  and  choose  a  red  fill.Note:  The  color  is  not  important.  This  example  uses  red  for  visibility 
and  contrast. 

4  Draw  a  rectangle  covering  the  entire  stage,  slightly  larger  than  the  stage. 

5  Now  select  yellow  as  the  fill  color.Note:  The  color  is  not  important.  This  example  uses  yellow  for  visibility  and 
contrast. 

6  Draw  a  rectangle  around  all  three  MENU  1  buttons.  Make  sure  all  three  buttons  are  completely  surrounded  by 
leaving  a  yellow  border  around  them. 

7  Using  the  Arrow  tool,  select  the  yellow  area.  Double-click  the  filled  area  so  that  both  the  fill  and  outline  are  selected 
and  delete  using  the  Delete  key. 

8  The  yellow  area  should  be  removed,  revealing  the  background.  Now  the  red  shape  covers  everything  except  the 
Menu  1  items,  and  will  become  the  rollover  area. 

9  With  the  Arrow  tool,  select  the  red  area. 

1 0  Choose  Insert  >  Convert  to  Symbol. 

1 1  Name  this  symbol  "Invisible  Button  1"  and  choose  "Button"  as  its  behavior.  Click  OK. 

1 2  Choose  Edit  >  Edit  Symbols. 

1 3  Highlight  the  "Hit"  frame  in  the  Button's  timeline  and  press  F6  to  insert  a  keyframe.  This  copies  the  red  area  from 
the  "Up"  frame  into  the  "Hit"  frame. 

14  Highlight  the  "Up"  frame  and  select  the  red  area  with  the  Arrow  tool. 

1 5  Press  Delete.  This  removes  the  red  area  from  the  "Up"  state.  This  button  now  only  has  content  in  the  "Hit"  state, 
making  it  an  invisible  button. 
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1 6  Choose  Edit  >  Edit  Movie.  The  previously  red  button  is  now  a  transparent  blue.  This  represents  the  invisible  button 
you  just  created.Note:  Flash  assigns  this  light  blue  color  to  buttons  that  are  "invisible".  Invisible  buttons  don't  have 
an  "Up"  state,  but  do  have  a  "Hit"  state.  Flash  shows  this  color  in  the  Flash  editor,  but  renders  this  invisible  in  the 
finished  movie. 

1 7  Click  this  transparent  blue  invisible  button  to  highlight  it. 

1 8  Choose  Modify  >  Instance. 

1 9  In  the  Actions  tab,  click  the  "+"  sign,  choosing  "OnMouseEvent".  On  the  right,  choose  "Roll  Over". 

20  Click  the  "+"  sign  again  and  choose  "Goto". 

21  On  the  right,  choose  "Label",  selecting  "START"  from  the  pop-up  menu.  Click  OK. 

Invisible  Button  2: 

1  Highlight  frame  20  of  the  Invisible  buttons  layer. 

2  Choose  Insert  >  Blank  Keyframe.Note:  This  must  be  a  BLANK  Keyframe  for  the  example  to  work. 

3  Choose  the  Rectangle  tool,  with  a  red  fill  color. 

4  Draw  a  rectangle  covering  the  entire  stage,  slightly  larger  than  the  stage. 

5  Now,  select  yellow  as  the  fill  color  and  draw  a  rectangle  around  all  three  MENU  2  buttons.  Make  sure  all  three 
buttons  are  completely  surrounded  by  leaving  a  yellow  border  around  them. 

6  Using  the  Arrow  tool,  select  the  yellow  area  and  delete  it.  The  yellow  area  should  be  removed,  revealing  the 
background. 

7  With  the  Arrow  tool,  select  the  red  area.  Double-click  to  select  the  line  surrounding  it  as  well. 

8  Choose  Insert  >  Convert  to  Symbol. 

9  Name  this  symbol  "Invisible  Button  2"  and  choose  "Button"  as  its  behavior.  Click  OK. 

1 0  Choose  Edit  >  Edit  Symbols. 

1 1  Highlight  the  "Hit"  frame  in  the  button's  timeline  and  press  F6  to  insert  a  keyframe. 

1 2  Highlight  the  "Up"  frame. 

1 3  Select  the  red  area  with  the  Arrow  tool.  Double-click  if  necessary  to  select  both  the  fill  and  the  line  surrounding  it 
and  delete.  This  removes  the  red  area  from  the  "Up"  state. 

14  Choose  Edit  >  Edit  Movie.  The  previously  red  button  is  now  a  transparent  blue.  This  represents  the  hidden  button 
you  just  created. 

1 5  Click  this  transparent  blue  invisible  button  to  highlight  it. 

1 6  Choose  Modify  >  Instance. 

1 7  In  the  Actions  tab,  click  the  "+"  sign,  and  choose  "OnMouseEvent".  On  the  right,  choose  "Roll  Over". 

1 8  Click  the  "+"  sign  again  and  choose  "Goto". 

1 9  On  the  right,  choose  "Label",  selecting  "START"  from  the  pop-up  menu.  Click  OK.  The  movie  is  now  complete. 

20  Select  Control  >  Test  Movie  view  the  finished  product.  If  you  have  problems,  open  a  new  document  and  try  again, 
following  the  steps  exactly. 
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Additional  information 

There  are  many  ways  to  create  pop-up  menus.  An  example  of  a  Hierarchical  Menu  is  also  available  from  the  Flash  menu, 
under  Samples  >  Hierarchical. 

For  tips  on  troubleshooting  a  Flash  movie,  please  refer  to  How  to  Troubleshoot  a  Flash  Movie  (TechNote  14218). 


How  to  create  password  verification 

Several  features  in  Macromedia  Flash  can  be  used  to  set  up  a  password  checking  system.  Using  editable  text  fields, 
variables,  and  the  conditional  If  statement,  a  mechanism  can  be  created  to  compare  a  password  to  a  predefined  string. 
The  result  is  evaluated  and  actions  based  on  whether  or  not  a  user  has  entered  the  correct  password  can  be  executed. 

The  procedure  outlined  in  this  TechNote  does  not  provide  a  high  level  of  security.  Client-side  password  verification  is 
subject  to  hacking  and  sabotage,  and  cannot  be  truly  secure.  It  is  still  possible  for  someone  to  intercept  a  password  or 
break  through  your  scheme,  and  Flash  movies  are  no  exception  to  this.  For  truly  secure  password  verification  use 
server-side  authentication. 

Note:  The  steps  in  this  TechNote  make  use  of  the  Push  Button  and  TextField  components.  These  components  belong 
to  Macromedia  Flash  UI  components  set  2  and  set  5,  respectively.  To  download  these  UI  components  go  to  the 
Macromedia  Exchange. 

There  are  three  main  steps  to  building  this  sample: 

•  Collect  the  data 

•  Compare  the  user's  entry  against  the  correct  password 

•  Decide  what  action  to  take  based  on  password  result 

Collect  the  Data 

1  Open  a  new  movie. 

2  Navigate  to  Windows  >  Component  and  drag  a  TextField  component  from  the  Component  window  found  in  Flash 
UI  components  Set  5. 

3  In  the  Property  inspector  name  the  instance  of  the  TextField  component  myText. 

4  Select  the  Parameters  tab  in  the  Property  inspector.  For  Type  choose  Input.  Select  True  for  Password  and  False  for 
Multiline  parameters.  Leave  other  parameters  as  default  values. 


Compare  the  Data 

1  Drag  a  Push  Button  component  from  the  UI  components  Set  2  and  type  a  name  for  Label  and  click  handler.  For  this 
example,  Submit  is  used  for  Click  Handler. 

2  Create  a  new  layer  named  Actions.  This  is  where  all  your  actions  should  reside  in  your  movie.  Select  the  first  frame 
of  the  Actions  layer,  open  the  Actions  panels  in  Normal  mode. 

3  Double-click  the  Stop  action  found  under  the  Movie  Control  folder  inside  the  Actions  folder.  This  will  prevent  the 
movie  to  from  playing  automatically  when  published  or  exported. 
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4  Under  the  Actions,  choose  Function  inside  the  User-Defined  Functions  folder.  Type  Submit  in  the  Name  text  field. 

5  Double-click  the  If  action  found  in  the  Conditions/Loops  folder  (Actions  >  Conditions/Loops  >  If). 

6  In  the  Conditions  field,  enter  myText.text  ==  "secret".  This  compares  the  value  of  password,  which  the  user  has 
entered  in  the  TextField  component,  with  the  string  "secret."  This  string  is  the  correct  password,  which  can  be 
defined  by  a  user. 

Send  the  User  to  the  correct  location 

1  Double-click  the  Goto  action  (Actions  >  Movie  Control  >  Goto).  Select  the  Goto  And  Stop  action.  Enter  3  in  the 
Frame  text  field.  This  will  be  the  action  that  is  executed  if  the  condition  is  true  and  will  provide  confirmation  that 
the  password  is  correct. 

2  Double-click  the  Else  statement  (Actions  >  Conditions/Loops>  Else).  Assign  a  Goto  action  in  the  following 
statement.  Enter  2  in  the  Frame  input  text  field.  Select  the  option  Go  to  and  Stop.  This  action  will  be  executed  if  the 
password  entered  by  the  user  is  incorrect. 

3  Insert  a  blank  keyframe  in  Frame  2. 

4  Create  or  drag  a  button  from  the  Library  panel  to  the  stage. 

5  Select  the  button  and  open  the  Actions  panel. 

6  Double-click  the  Goto  action.  This  action  will  take  the  user  to  the  first  frame  of  the  movie  if  password  entered  is 
incorrect. 

7  Insert  a  blank  keyframe  in  Frame  3. 

8  Click  the  Text  tool  and  make  sure  that  Static  text  is  selected  as  the  text  type  in  the  Property  inspector.  Type  a 
confirmation  message  that  tells  the  user  they  have  successfully  entered  the  password. 


How  to  create  a  color  fade  effect  in  Flash 

Tweening  color  effects  A  fade-out  effect  is  achieved  in  Flash  by  creating  a  Motion  Tween,  and  adjusting  the  Alpha 
property  of  a  Symbol.  A  simple  example  of  creating  this  effect  is  provided  below.  The  Symbol  created  will  fade  out  over 
the  duration  of  ten  frames.  The  instructions  provided  are  written  for  Flash  5.  However,  if  you  are  using  a  previous 
version  of  Flash,  the  basic  method  is  the  same. 

This  process  can  be  applied  to  any  Symbol,  including  those  containing  text.  Make  sure  that  the  object  has  been 
converted  to  a  Symbol  before  applying  a  Motion  Tween. 

A  basic  example 

To  fade  a  blue  circle  to  white  over  ten  frames,  do  the  following: 
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1 

Open  a  new  document,  with  a  white  background. 

2 

Select  the  Circle  Tool,  using  a  blue  color.  (Or  any  other  desired  color). 

3 

Draw  a  circle  on  the  Stage. 

4 

Double-click  the  circle  to  highlight  both  the  line  and  fill. 

5 

Choose  Insert  >  Convert  to  Symbol.  Select  "Graphic"  and  click  OK. 

6 

Select  frame  1 0  in  the  Timeline.  Choose  Insert  >  Keyframe. 

7 

Highlight  the  Symbol  on  the  Stage.  Select  Modify  >  Instance. 

8 

Choose  the  Effects  Panel. Noteiln  previous  versions,  this  is  called  the 
"Color  Effect"  panel. 

9 

Choose  "Alpha"  from  the  pop-up  menu. 

10 

Enter  the  number  "0"  as  the  percent.  Hit  the  Enter  key  on  your 
keyboard  to  activate  the  change. 

11 

Highlight  frame  1  and  choose  Modify  >  Frame,  to  access  the  Frame 
panel. 

12 

In  the  Tweening  dialog  box,  choose  "Motion"  from  the  menu.Note:ln 
previous  versions,  this  can  be  found  as  a  Tweening  tab.  Hit  the  Enter 
key  to  activate  the  change. 

13 

Choose  Control>  Test  Movie  to  see  the  fade  effect. 

Create  buttons  |  Flash 

Buttons  are  symbols  that  contain  four  frames.  Each  frame  of  a  button  symbol  represents  a  different  state  for  the  button: 
Up,  Over,  Down,  and  Hit.  These  states  determine  how  a  button  visually  behaves  when  the  mouse  is  rolled  over  it  or 
when  the  user  clicks  the  button.  This  document  explains  how  to  create  basic  and  advanced  buttons. 


Create  a  basic  button 

1  Choose  Insert  >  New  Symbol,  or  press  Control+F8  (Windows)  or  Command+F8  (Mac  OS).Note:  In  Flash  3  and 
earlier,  deselect  everything  on  the  stage  and  choose  Insert  >  Create  Symbol. 

2  In  the  Symbol  Properties  dialog  box,  enter  a  name  for  the  new  button  symbol  and  choose  Button  as  the  Behavior 
option.  Click  OK.  Flash  switches  to  symbol-editing  mode.  The  Timeline  header  changes  to  display  four  consecutive 
frames  labeled  Up,  Over,  Down,  and  Hit.  The  first  frame,  Up,  is  a  blank  keyframe. 

3  To  create  the  Up  state  button  image,  use  the  drawing  tools,  import  a  graphic,  or  place  an  instance  of  another  symbol 
on  the  Stage.  You  can  use  either  a  movie  clip  or  graphic  symbol  in  a  button.  However  you  cannot  use  another  button 
in  a  button.  Use  movie  clip  symbols  if  you  want  to  create  an  animated  button. 

4  Select  the  second  frame,  labeled  Over,  and  choose  Insert  >  Keyframe.  The  button  image  from  the  first  frame  appears 
on  the  Stage. 
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5  Change  the  button  image  for  the  Over  state.  Repeat  steps  4  and  5  for  the  Down  frame  and  the  Hit  frame.Note:  The 
Hit  frame  is  not  visible  on  the  Stage  on  playback,  but  it  defines  the  area  of  the  button  that  responds  when  clicked. 
Make  sure  that  the  Hit  frame  graphic  is  a  solid  area  large  enough  to  encompass  all  the  graphic  elements  of  the  Up, 
Down,  and  Over  frames.  It  can  also  be  larger  than  the  visible  button.  If  you  do  not  specify  a  hit  frame,  the  objects  in 
the  Up  state  are  used  as  the  hit  frame. 

6  After  you  define  the  images  of  the  four  button  states,  choose  Edit  >  Edit  Movie  to  exit  Symbol  Edit  mode. 

7  Open  the  Library  window  by  choosing  Window  >  Library.  Locate  the  button  in  the  Library  window  and  then  drag 
the  button  symbol  out  of  the  Library  onto  the  Stage.  This  step  creates  an  instance  of  the  button  in  the  movie. 

For  information  on  assigning  actions  to  the  button  instance,  see  the  documentation  that  applies  the  version  of  Flash 
that  you  are  using.  The  documentation  follows  below: 

Assign  a  simple  action  to  a  button  (Flash  5) 

1  In  Edit  Movie  mode,  select  the  button  instance  created  in  Step  7  above. 

2  Choose  Window  >  Actions  to  open  the  Actions  panel. 

3  In  the  Toolbox  list  on  the  left  side  of  the  panel,  click  the  Basic  Actions  category  to  display  the  basic  actions. 

4  To  assign  an  action,  do  one  of  the  following: 

•  Double-click  an  action  in  the  Basics  Actions  category. 

•  Drag  an  action  from  the  Basic  Actions  category  on  the  left  to  the  Actions  list  on  the  right  side  of  the  panel. 

•  Click  the  Add  (+)  button  and  choose  an  action  from  the  pop-up  menu. 

•  Use  the  keyboard  shortcut. 

5  If  the  chosen  action  has  any  associated  parameters,  those  parameters  appear  in  the  Parameter  pane  at  the  bottom  of 
the  Actions  panel.  (If  the  Parameter  pane  is  not  visible  click  the  small  triangle  in  the  lower  right  corner  of  the  panel.) 
Choose  or  type  the  parameters  appropriate  for  that  action.  For  example,  thegotoAndPlay  action  shown  below 
contains  three  parameters:  Scene,  Type,  Frame,  and  an  option  for  Goto  and  Play. 


Assign  a  simple  action  to  a  button  (Flash  4  and  earlier) 

1  In  Edit  Movie  mode,  select  the  button  instance  created  in  Step  7  above. 

2  Make  sure  that  Enable  Buttons  from  the  Control  menu  is  deselected. 

3  Double-click  the  button  to  get  the  Instance  Properties  dialog  box.Note:  In  Flash  2,  this  dialog  box  was  the  Link 
Properties:  Button  dialog  box. 

4  Assign  the  action  by  selecting  the  Action  tab  in  the  Instance  Properties  dialog  box.  Then,  click  the  plus  (+)  button 
and  double-click  the  appropriate  action.Note:  In  Flash  2  assign  the  action  using  the  Action  pop-up  menu  in  the  Link 
Properties:  Button  dialog  box.  Only  one  action  can  be  assigned  to  the  button. 

5  Make  sure  that  Enable  Buttons  in  the  Control  menu  is  checked,  so  that  option  is  toggled  back  on. 

6  If  the  selected  action  has  any  associated  parameters,  those  parameters  appear  in  the  Parameter  panel  on  the  right 
side  of  the  Actions  panel.  Choose  or  type  the  parameters  appropriate  for  that  action. 


Create  advanced  buttons 

After  you've  mastered  a  simple  button,  try  more  complex  Flash  buttons.  You  can  create  invisible  buttons,  buttons  with 
animated  states,  and  buttons  with  rollover  effects. 
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Hit  states  are  important  to  understand  when  designing  a  complex  button.  The  button's  shape  and  area  represent  the 
active  area  of  the  button.  To  experiment  with  the  Hit  state,  do  the  following: 

1  Introduce  a  button  from  the  Common  Libraries  onto  the  Stage.  Edit  the  button. 

2  Highlight  the  frame  in  the  button's  Hit  state,  and  insert  a  Keyframe.  Test  this  behavior  in  a  movie. 

3  Resize  the  object  in  the  Hit  state  dramatically,  and  test. 

4  Delete  the  Keyframe  in  the  Hit  State  and  test  the  button. 

5  Notice  the  effect  on  your  button  cursor,  and  the  Up,  Over  and  Down  states  that  you  see  when  the  button  is  enabled. 

Invisible  buttons 

The  Up,  Over  and  Down  states  of  a  button  can  be  left  empty.  If  these  states  are  empty,  it's  necessary  to  define  the  Hit 
state  so  that  it  contains  content. 

When  the  Up  state  of  the  button  is  empty  or  invisible,  the  button  is  represented  on  the  Stage  by  a  blue  shape.  The  shape 
is  the  equivalent  to  the  content  in  the  next  Keyframe  within  the  button.  This  blue  shape  isn't  visible  in  your  final  movie. 
See  the  example  below. 

Buttons  with  animated  states 

To  make  animated  buttons  in  Flash,  place  a  Movie  Clip  in  the  button  state  that  you  are  animating. 

1  Create  a  movie  clip  for  each  state  of  the  button  that  you  want  animated. 

2  Create  the  button. 

3  Place  the  movie  clips  in  the  button  states  to  animate. 

4  Place  the  button  on  the  stage.  Note:  Movie  clips  cannot  be  tested  in  the  Flash  editor.  Choose  Control  >  Test  Movie 
or  export  it  as  a  SWF  file  to  test  it. 

See  the  example  below. 

A  rollover  in  one  area  of  the  movie  affects  another  area  of  the  movie 

To  create  this  effect,  move  the  Hit  state  elements  to  a  different  area  of  the  Stage  than  elements  in  the  Over  state  of  the 
button.  This  method  works  for  simple  rollover  effects.  The  active  area  of  the  button  is  located  in  a  different  area  onstage 
than  the  rollover  effect.  See  the  example  below 

Example 

Note:  Flash  Player  is  required  to  view  the  example. 

•  Download  the  Windows  source  file  advanced_biittons.zip  (17  K) 

•  Download  the  Mac  OS  source  file  advanced_buttons.sit  (18  K) 

Note:  Flash  4  or  later  is  required  to  open  the  source  file. 


Additional  information 

A  good  way  to  learn  more  about  buttons  and  their  construction  is  to  study  the  buttons  included  as  samples  with  Flash. 
In  Flash  5,  these  sample  buttons  are  available  from  the  Windows  >  Common  Libraries  >  Buttons  menu.  If  you  use  Flash 
4,  you  can  access  these  buttons  by  choosing  Libraries  >  Buttons.  For  Flash  2,  the  libraries  of  sample  buttons  are 
accessible  from  the  Xtras  menu. 

A  walkthrough  of  creating  a  button  is  also  available  in  the  Lessons  that  come  with  Flash  5.  Choose  Help  >  Lessons  >  06 
Buttons  from  within  Flash  to  access  this  lesson. 
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Constrained  drag  does  not  align  correctly  in  Flash  CS3 
Professional 


Issue 

Using  a  constrained  drag  (holding  the  Shift  key  when  dragging)  in  Adobe  Flash  CS3  Professional  does  not  correctly 
align  the  object  being  dragged  to  its  original  location. 


Solution 

Instead  of  using  a  constrained  drag,  you  can  rely  on  object  snapping  to  align  the  object  being  dragged  to  its  original 
location.  If  not  already  enabled,  you  can  enable  object  snapping  by  selecting  Grid  >  Snapping  >  Snap  To  Objects.  This 
will  allow  you  to  align  your  object  vertically  or  horizontally  but  not  diagonally. 

There  is  no  workaround  for  a  constrained  diagonal  drag,  however,  you  will  experience  less  variation  in  the  offset  if  you 
click  on  the  object's  center  before  dragging  it.  You  can  also  manually  input  values  for  the  object's  new  location  or  use 
the  keyboard  arrow  keys  to  move  an  object  in  a  diagonal  direction. 


Captioning  button  in  FLVPIayback  skins  fail  to  work  if 
FLVPIaybackCaptioning  showCaptions  is  set  to  false 


Issue 

Some  skins  for  the  FLVPIayback  component  for  ActionScript  3.0  in  Adobe  Flash  CS3  Professional  have  built-in 
captioning  buttons  (CaptionButtons).  These  buttons  can  be  used  with  the  FLVPIaybackCaptioning  component  to 
manage  captions  used  with  your  FLV.  If  you  set  the  showCaptions  property  in  the  parameters  panel  for  the 
FLVPIaybackCaptioning  component  to  false,  captioning  buttons  within  these  skins  fail  to  function. 


Reason 

FLVPIaybackCaptioning  components  will  automatically  detect  and  associate  CaptionButtons  within  FLVPIayback 
skins  with  itself  to  add  to  those  buttons  captioning  toggling  capabilities.  A  FLVPIaybackCaptioning  component, 
however,  only  does  this  when  it  sees  there's  a  need  for  association  (when  showCaptions  is  true)  and  only  at  the  point  in 
time  when  the  skin  loads.  If  the  skin  loads  and  showCaptions  is  false,  the  association  is  never  made. 
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Solution 

If  it  is  not  set  already,  set  showCaptions  property  in  the  parameters  panel  for  the  FLVPlaybackCaptioning  component 
to  true.  When  the  skin  loads,  the  skin  will  be  recognized  by  FLVPlaybackCaptioning  and  the  CaptionButton  within  will 
be  correctly  associated  with  the  component.  As  soon  as  that  happens,  you  can  set  showCaptions  back  to  false  using 
ActionScript  by  listening  for  the  SKIN_LOADED  event  of  the  FLVPlayback  component. 

import  fl .video .VideoEvent ;  //  listen  for  when  the  skin  has  loaded  into  the  //  FLVPlayback 

component  (myFLVPB) .  When  that  //  happens  call  the  skinLoaded  handler 

myFLVPB . addEventListener (VideoEvent . SKIN_LOADED,  skinLoaded) ;  //  The  skinLoaded  event  handler 

will  set  showCaptions  //  to  false  after  the  FLVPlaybackCaptions  component  (myFLVCP)  //  has 
associated  itself  with  the  CaptionButton  in  the  skin  function 
skinLoaded (event : VideoEvent ): void  {  myFLVCP . showCaptions  =  false;  } 


Cannot  import  EPS  (Flash) 


Issue 

When  you  attempt  to  import  EPS  files  into  Adobe  Flash  CS3  Professional,  this  error  appears:  "One  or  more  files  were 
not  imported  because  there  were  problems  reading  them."  This  may  occur  with  files  that  imported  correctly  in  previous 
versions  of  Flash. 


Reason 

Due  to  changes  in  the  PostScript  interpreter  in  Adobe  Flash  CS3  Professional,  some  EPS  files  may  no  longer  import. 


Solution 

To  enable  importing  of  EPS  files,  open  each  EPS  file  in  Adobe  Illustrator.  Save  the  file  in  AI  format,  and  import  the 
resulting  file  into  Flash. 

Additionally,  you  can  resave  the  file  using  any  other  Postscript  application  that  can  be  imported  into  Flash. 


Calling  Flash  ActionScript  functions  using  Lingo 

Flash  files  in  Director  MX  2004 

Director  MX  2004's  object  model  allows  direct  access  to  an  SWF  movie  clip  and  ActionScript  functions.  ActionScript 
functions  can  be  called  directly  without  setting  up  an  object  reference  usinggetVariable().  Movie  clips  can  be  referenced 
via  Lingo  or  JavaScript  syntax. 


Setting  up  the  object  reference  and  calling  a  function 


► 

The  following  custom  handler  first  returns  an  object  reference  to  a  movie  clip  named  'myClip'.  The  second  statement  fires  off  a  function  named 
'Calculate^  in  the  same  movie  clip. 

--example  1  global  myObj  on  callFlashFunction  me  myObj=sprite(flashSprite). myClip  myObj.Calculate()  end  --example  2  on  Mousellp  me 
sprite(flashSprite).myClip.Calculate()  end 
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To  use  the  newObject  command  in  Director,  use  either  the  Flash  sprite  command  or  the  global  Flash  command.  For 
more  information  see  "newObjectO"  in  the  Director  Lingo  Dictionary.  There  is  also  some  downloadable  sample  code 
inGlobal  Flash  command  for  creating  an  ActionScript  object  (TechNote  16691). 

Flash  files  in  Director  MX 

When  using  Director  MX,  object  references  can  be  made  to  a  Flash  movie  timeline.  This  functionality  allows  control 
over  Flash  movies  and  individual  Flash  objects.  An  object  reference  is  created  by  calling  a  getVariable()  command  on 
a  specific  sprite.  The  getVariable()  command  is  used  in  two  ways:  to  return  the  literal  value  of  a  Flash  variable  (TRUE) 
or  to  return  an  object  reference  (FALSE).  For  more  information  see  "getVariable()M  in  the  Director  MX  Lingo 
Dictionary.  Also,  see  the  following  section  in  Director  MX  Help:  Media  >  Using  Flash  and  Other  Interactive  Media 
Types. Using  getVariable()  and  object  references  to  control  a  Flash  sprite  The  code  below  demonstrates  how  to  use 
getVariable()  and  object  references  to  control  a  Flash  sprite. 


Setting  up  the  object  reference 


► 

Set  up  the  object  reference  to  the  main  timeline  of  the  Flash  movie  using  thegetVariable()  command.  This  is  achieved  by  setting 
the"returnValueOrReference"  parameter  to  FALSE.  The  following  script  creates  a  reference  to  the  timeline. 

global  myObj  on  beginSprite  me  myObj=getvariable(sprite(flashSprite),"_levelO", False)  end 

Using  the  object  reference 


► 

Once  the  reference  has  been  set  up,  Lingo  can  be  used  to  call  user-defined  functions  in  the  Flash  movie.  For  example,  the  following  script  will 
call  a  custom  Flash  function  'doSomethingO'  in  the  timeline  of  the  main  Flash  movie: 

global  myObj  myObj.doSomethingO 

The  object  reference  will  handle  parameters  if  the  function  has  been  defined  to  accept  parameter  information. 


► 

The  reference  can  also  be  used  to  control  the  timeline  of  the  Flash  movie  using  standard  ActionScript.  This  statement  sends  the  play  head  of 
the  Flash  movie  to  frame  1 0  and  instructs  the  movie  to  play  from  that  frame: 

global  myObj  myObj.goToAndPlay(IO) 


► 

An  object  reference  can  be  expanded  to  control  the  play  head  of  a  movie  clip  and  call  user-defined  functions  that  are  defined  in  the  timeline 
of  the  movie  clip.  The  first  statement  of  this  sample  script  sends  the  play  head  of  a  movie  clip  named  'myClip'  to  frame  20.  The  second  statement 
fires  off  a  function  named  Calculate!)': 


global  myObj  myObj. myClip.goToAndStop(20)  myObj. myClip.CalculateQ 


Tips  and  Tricks 


Last  updated  1 1  /6/201 5 


58 


► 

Use  the  new  Object  Inspector  to  examine  the  hierarchy  of  elements 
inside  Flash  MX  sprites.  The  ability  to  quickly  examine  all  your  movie 
components  reduces  both  debugging  and  development  time.  For 
example  enter  sprite  reference  into  the  01  and  explore  the  results: 
sprite(l) 

► 

When  working  in  Flash,  make  sure  to  assign  unique  instance  names  to 
movie  clips.  This  will  make  it  easier  to  reference  these  objects  in 
Director. 

► 

When  working  with  a  specific  movieclip  that  is  deeply  nested  within 
other  movieclips,  it  is  advisable  to  create  an  object  reference  that  will 
directly  point  to  that  specific  movieclip. 

► 

Flash  movies  that  are  loaded  using  theloadMovie( )  ActionScript 
command  can  also  be  targeted.  To  do  this,  pass  the  specific  level  of  the 
movie  using  the  parameter  variableName  within  thegetVariable() 
command. 

Additional  InformationHow  do  I  use  get  Variable  and  set  Variable  with  a  Flash  movie?  (TechNote  14798)How  do  I  pass 
a  Variable  from  Flash  to  Director?  (TechNote  14796)Using  Flash  cast  members  in  Director  moviesGlobal  Flash 
command  for  creating  an  ActionScript  object  (TechNote  16691) 


Blinking  classic  tweens  after  changing  jpeg 
compression  (Flash  CS4  Professional) 


Issue 

Classic  tweens  containing  bitmaps  blink  and  behave  incorrectly  when  JPEG  Compression  is  applied  to  the  bitmap  or  if 
the  original  compression  value  is  changed. 

For  example,  if  you  have  a  Flash  CS3  FLA  in  which  a  bitmap  is  used  in  a  tween,  and  that  bitmap  has  Lossless 
compression  applied,  it  will  open  and  play  correctly  in  Flash  CS4  Professional.  However,  if  that  bitmap's  properties  are 
selected  in  the  Library  and  Photo  (JPEG)  compression  is  applied,  the  tween  may  no  longer  run  correctly. 

Similarly,  if  you  have  a  Flash  CS3  or  Flash  8  FLA  in  which  a  bitmap  is  used  in  a  tween,  and  that  bitmap  already  has 
Photo  (JPEG)  compression,  it  will  open  and  play  correctly  in  Flash  CS4  Professional.  However,  if  that  bitmap's 
properties  are  selected  and  the  compression  value  is  changed  to  a  different  percentage,  the  tween  may  no  longer  run 
correctly. 


Reason 

This  is  a  known  issue  in  Flash  CS4  Professional. 


Solution 

This  issue  will  be  addressed  in  a  future  update  of  Flash  CS4  Professional. 

In  the  meantime,  there  are  several  possible  ways  to  work  around  the  issue: 

•  If  possible,  rebuild  the  classic  tween  using  a  Flash  CS4  motion  tween.  For  more  information  read  "Differences 
between  motion  tweens  and  classic  tweens"  in  Flash  CS4  Help. 
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•  If  possible,  replace  the  bitmap  art  with  vector  art  drawn  in  Flash  or  another  vector  application  such  as  Adobe 
Illustrator. 

•  If  neither  of  the  above  is  possible  the  issue  can  be  worked  around  by  adding  a  motion  tween  to  the  same  symbol  that 
is  currently  failing  to  tween  correctly.  For  example: 

•  Open  the  problem  symbol  in  Edit  mode 

•  Add  a  new  layer 

•  Place  an  instance  of  any  symbol  in  frame  1.  This  can  be  offstage  if  necessary. 

•  Right-click  the  new  layer 

•  Choose  "Create  Motion  Tween'These  actions  will  resolve  the  issue.  At  this  point  you  can  delete  the  symbol 
instance  from  frame  1,  and  the  issue  will  still  be  resolved.  In  some  cases  you  may  also  be  able  to  delete  the  new 
layer  without  problems,  but  this  has  not  been  thoroughly  tested. 


AVI  files  exported  from  Adobe  Flash  on  Windows  Vista 
do  not  play  in  Windows  Media  Player 


Issue 

When  using  Windows  Media  Player  to  open  an  AVI  file  exported  from  Adobe  Flash  authoring  on  Windows  Vista,  you 
get  the  error  message  below. 

Windows  XP: 

"Windows  Media  Player  encountered  an  unknown  error.  Windows  Media  Player  cannot  play  the  file.  One  or  more 
codecs  required  to  play  the  file  could  not  be  found." 

Windows  Vista: 

"Windows  Media  Player  cannot  play  the  file.  The  Player  might  not  support  the  file  type  or  might  not  support  the  codec 
that  was  used  to  compress  the  file." 

Note:  This  issue  effects  both  Flash  CS3  and  Flash  CS4  Professional  when  authoring  on  Windows  Vista  only.  This  issue 
will  not  occur  when  authoring  with  Flash  on  Windows  XP. 


Reason 

On  Vista,  certain  video  export  options  create  files  which  cannot  be  played  in  Windows  Media  Player. 

Solution 

When  using  Flash  authoringon  Vista,  export  to  AVI  using  the  following  guidelines: 

•  For  all  video  format  color  depths,  always  select  "Compress  video"  and  avoid  using  "Full  Frames  (Uncompressed)"  as 
the  Video  Compression  method. 

•  For  8-bit  color,  only  use  the  "Cinepak  Codec  by  Radius"  or  "Intel  IYUV"  as  the  Video  Compression  method. 
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Adding  actions  to  shared  buttons 

Shared  libraries  in  Macromedia  Flash  allow  multiple  movies  to  reference  a  single  media  asset  such  as  a  graphic,  movie 
clip  or  sound.  During  authoring,  shared  symbols  can  improve  workflow  by  allowing  teams  of  designers  to  easily  share 
media.  During  playback,  shared  assets  download  once  and  can  be  used  by  several  movies,  reducing  file  size  and 
download  time. 

Due  to  the  nature  of  shared  symbols,  however,  actions  cannot  be  applied  to  instances  of  shared  buttons.  One  solution 
is  to  place  an  instance  of  the  button  inside  an  empty  movie  clip  and  apply  actions  to  that  button  instance.  This  "parent" 
movie  clip  symbol  is  then  shared,  rather  than  the  button  itself.  However,  this  results  in  the  same  action  being  executed 
for  each  instance  of  that  shared  movie  clip.  Another  solution  is  to  use  shared  graphics  inside  a  locally  created  button 
symbol.  Different  actions  could  be  attached  to  separate  instances  of  this  button  symbol,  since  it  is  local  to  the  current 
movie.  This  method,  however,  requires  keeping  track  of  multiple  imported  graphic  symbols. 

Smart  clips,  new  in  Flash  5,  provide  one  way  to  easily  allow  different  instances  of  the  same  shared  button  symbol  to 
perform  different  actions.  Similar  to  the  first  solution  mentioned  above,  a  button  symbol  is  "nested"  inside  another 
movie  clip.  Actions  applied  to  the  button  include  ActionScript  variables,  such  as  parameters  to  functions  or  actions. 
Clip  parameters  that  correspond  to  those  ActionScript  variables  are  added  to  the  parent  movie  clip,  which  is  then 
exported  as  a  shared  item.  In  movies  that  import  this  movie  clip,  it's  easy  to  customize  the  behavior  of  each  button/ clip 
instance  using  the  Clip  Parameters  panel. 

An  example  The  steps  below  explain  how  to  create  a  shared  button  whose  instances  will  open  different  URLs  from 
agetURL()action.  The  first  part  involves  creating  the  shared  button  and  assigning  clip  parameters  to  its  parent  clip. 

To  make  the  shared  button  symbol: 


1 

Open  a  new  movie  in  Flash  and  save  it  as  shared.fla. 

2 

Create  a  new  movie  clip  symbol  (Insert  >  Symbol)  and  give  the  symbol 
a  name  like  button_parent,  for  example. 

3 

Add  a  button  to  this  movie  clip's  Timeline,  such  as  one  of  the  buttons 
from  the  Buttons  common  library  (Window  >  Common  Libraries  > 
Buttons). 
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Attach  the  following  action  to  the  button  instance: 
on  (release)  { getURL  (theURL); } 

If  working  in  Normal  scripting  mode,  be  sure  to  select  the  Expression 
option  next  to  the  URL  field. 


Object  Actions 


1 1  Movie  Explorer  [  >J  Object  Actions| 

+  —  Object  Actions 


T1  I  on  (release)  { 


getURL  (theURL) ; 


Line  2:  getURL  (theURL); 


URL:  [theURL 

17  E> 

Window:  | 

Variables:  |  Don't  send 

- 3 

5 


6 


7 


Open  the  Library  window  (Window  >  Library)  and  select  the 
button_parent  symbol.  Choose  Define  Clip  Parameters  from  the 
Library  window's  Options  menu. 


Click  the  Add  (+)  button  at  the  top  of  the  Clip  Parameters  dialog  to  add 
a  new  name/value  parameter  pair. 


Select  the  Name  field  by  double-clicking  it,  and  entertheURLas  the 
parameter  name,  as  shown  below. 


n  _ _ i _ 

+  - 

▼  A. 

Name 

Value 

Trjpe: 

theURL 

defauItValue 

Default 

8 


Leave  the  the  other  fields  at  their  default  values. 


Click  OK. 


9 


Select  the  button_parent  symbol  in  the  Library  window  again,  and 
choose  Linkage  from  the  Options  menu. 
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10 


In  the  Symbol  Linkage  Properties  dialog,  select  the  Export  this  symbol 
option  and  enter  a  string  in  the  Identifier  field. 


11 


13 


12 


Click  OK. 


Publish  (export)  the  file  as  shared.swf  to  the  same  folder  as  shared.fla. 


Save  and  close  shared.fla. 


The  next  step  is  to  import  button_parent  into  a  new,  host  movie  and  add  instances  of  the  clip  to  the  Timeline.  The  Clip 
Parameters  panel  is  used  to  modify  the  getURL  action  applied  to  each  button  instance. 

To  import  the  movie  clip  and  customize  the  getURL  action: 


1  Open  a  new  Flash  movie  and  save  it  as  host.fla  to  the  same  folder  that 

contains  shared.fla  and  shared.swf. 


2  Choose  File  >  Open  as  Shared  Library  and  open  shared.fla.  The  Library 

window  for  that  FLA  should  appear  containing  the  button_parent 
symbol  as  well  as  the  actual  button  (named  Grey_button,  in  this  case). 


3 


4 


Note:  If  the  Library  window  does  not  appear,  make  sure  that  shared.fla 
is  not  open  for  editing  in  the  background.  If  it  is,  close  shared.fla  and 
repeat  this  step. 


Drag  two  or  three  instances  of  button_parent  (not  the  button  symbol 
itself)  from  shared.fla's  the  Library  window  to  the  stage.  (See  note 
below  about  nested  shared  symbols.) 


Select  one  of  the  movie  clip  instances  and  open  the  Clip  Parameters 
dialog  (Window  >  Panels  >  Clip  Parameters). 
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5 


Double-click  the  Value  field  to  select  it  and  enter  a  URL,  such  as 
http://www.macromedia.com. 


6 


Repeat  this  step  for  the  other  clip  instances,  entering  a  different  value 
fortheURL. 


Save  the  movie  to  the  same  directory  as  shared.fla  and  shared.swf. 


Note:  You  can  save  the  movie  to  another  directory  but  you  would 
need  to  change  the  Linkage  property  for  the  imported  button_parent 
symbol. 

7  Preview  and  test  the  movie  in  a  browser  (File  >  Preview).  Each  button 

should  open  a  browser  window  with  different  URLs. 


A  note  about  "nested"  shared  symbols  When  you  import  a  shared  symbol  that  contains  other  symbols,  those  "nested" 
symbols  also  appear  in  the  host  movie's  Library  window.  This  is  the  case  even  if  the  nested  symbols  are  not  shared 
themselves.  For  instance,  in  the  above  example,  the  movie  clip  named  button_parent  contains  a  button  named 
Grey_button.  Just  the  movie  clip  has  been  shared  and  imported,  but  both  the  button  and  its  parent  movie  clip  appear 
in  the  host  movie's  Library. 

If  you  attempt  to  edit  the  shared  movie  clip  symbol,  button_parent,  Flash  presents  you  with  the  following  warning: 


Shared  symbols  can  only  be  edited,  and  remained  linked,  if  changes  are  made  to  the  symbol  in  its  original  movie 
(shared.fla,  in  this  case.)  If  you  click  Yes  to  the  above  warning  dialog,  the  shared  symbol  will  be  fully  imported  into  the 
host  movie.  That  is,  it  will  no  longer  be  linked. 

However,  the  same  warning  does  not  appear  if  you  attempt  to  edit  Grey_button,  a  symbol  nested  inside  of  the  shared 
symbol  button_parent.  This  is  somewhat  misleading  as  nested  symbols  appear  only  as  placeholders  for  their  linked 
counterparts.  For  example,  changes  made  to  Grey_button  will  only  appear  while  authoring  the  host  movie  in  Flash. 
During  playback,  the  external  Library  item  is  referenced  and  displayed. 

Changing  the  appearance  of  the  imported  button  To  change  the  appearance  of  the  imported  button  symbol,  open 
shared.fla  and  make  the  desired  changes  to  the  original  button  symbol.  Re-export  the  Flash  movie  as  an  SWF  to  its  same 
location. 
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